Presentation Template

*This is a template for SVDS presentations. Blue boxes in the template convey information about using the template. Remove these before sharing with clients*
Yellow boxes hold important messages to keep in mind. Remove these before sharing with clients as well.

Use markdown cells to begin each section with a heading, and subsections with subheadings, using # and ## and ### in descending hierarchy.

The template is not intended to be an overly rigid document. Violations of the template are acceptable as long as they substantively improve the presentation and have a valid purpose. However, if the template is regularly being modified in a specific way then the template itself should be forked or modified.

Recognize that violations of the template come at a cost to the reader who has to adjust to the changes and come at a cost, so **modify with care**

Introduction

Purpose

This section describes what this notebook is for, and why the reader should care about what they are reading

Guiding Questions:

  1. Question 1
  2. Question 2
  3. Question 3
  4. ....
*This part of the document is an explanation of the key hypothesis and questions of interest. The notebook should explore either a single Agile story broken into subsections. If multiple stories need to be discussed it would generally be better to use two notebooks so the thematic flow is retained.*

Key Findings

  1. Finding 1
  2. Finding 2
  3. Finding 3
  4. ...
*This part of the document is an explanation of the key results that will be shared below. The idea is to inform the reader what they will be seeing in the document below. This establishes the messages of the analysis below and helps the users understand what they will be seeing.*

Notes

Optional, Remove if Unused
*This section should include any notes to reader, such as major issues with data quality or other points of concern they should be aware of. This section is optional and depends on the needs of the document*

Data Input

Data may change over time (tables getting updated) so that the same query returns different results depending on _when_ the query was run. If this is a possibility, mention it and its likely impacts.
  • File/table name:
  • Query date:
  • Description of data:
  • Date range covered by data:
  • Included population:
  • Associated query file:
  • Associated query:

In [1]:
######
# 
# Library/Package Loads
#
# This section should contain all library/package loads required for the code.
#
######

%matplotlib inline
%config InlineBackend.figure_format='retina'
# %load_ext autoreload
# %autoreload 1

from __future__ import absolute_import, division, print_function
import matplotlib as mpl
from matplotlib import pyplot as plt
from matplotlib.pyplot import GridSpec
import seaborn as sns
import mplsvds
import mpld3
import numpy as np
import pandas as pd
import os, sys
from tqdm import tqdm
import warnings

sns.set_context("poster", font_scale=1.3)

In [2]:
######
#
# Configurations
#
# This section contains specific configurations required by the code 
# going forward, including formatting options.
#
######

def define_paths():
    paths = {}
    paths['working'] = os.path.abspath(os.path.curdir)
    main = os.path.split(os.path.split(paths['working'])[0])[0]
    strike = os.path.split(os.path.split(main)[0])[0]
    for directory in ['source','data','develop','report']:
        paths[directory] = os.path.join(main, directory)
    paths['sql'] = os.path.join(paths['source'], directory)
    paths['src'] = os.path.join(strike, 'src')
    return paths

paths = define_paths()

# Notebook variables and settings
user = os.path.expanduser('~').split('/')[-1]
os.system("kinit -k -t /home/{u}/.keytabs/{u}.keytab -p {u}".format(u=user))
sys.path.append(paths['src'])

######
#
# Source Files
#
# This section should contain other source files loaded before the code runs.
# Preferably some note of the features of the source files would be appropriate.
#
######

Analysis Sections

*These sections should contain the core results of the analysis.*

Some general rules:

***Not everything you have done in your work should be shown.*** *Focus on the main points. Have the work available if needed but someone looking at your work has not completed every step, nor are they likely to have time to do so.*
***Develop a thematic message*** *Make it easy for the person looking at your presentation to understand the major points. Be prepared to discuss minor points, or address specific questions, but prepare the topic so that the key takeaways and important efforts are clear.*
***Emphasize the key takeaways, strive for clarity*** *This is a presentation, not a raw document. The person seeing your work has not gone through the rigorous evaluation you have. They don't know every nook and cranny. They need you to point out things that became obvious to you as part of your analysis. Provide strong takeaways.*

Guiding Question / Hypothesis 1

Key Finding 1

Conclusions

This section should wrap up the main ideas expressed above, and should contain a basic repeat of the findings addressed above along with suggested action items. The findings in this section should be slightly more detailed, in that at this point the user should have seen the work and you can reference specifics.

Key Findings

  1. Finding 1
  2. Finding 2
  3. Finding 3
  4. ...

Action Items

  1. Item 1
  2. Item 2
  3. Item 3

Appendix


In [3]:
# Currently doesn't work, but putting the versions of libraries used at the end is probably a good idea.
# %install_ext http://raw.github.com/jrjohansson/version_information/master/version_information.py
# %load_ext version_information
# %reload_ext version_information
# %version_information numpy, matplotlib, pandas

© 2017 Silicon Valley Data Science LLC