Skip to content

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 

README.md

This template folder is designed to be a guide for making the tutorials in this repository. The Contextual Dynamics Lab does ask that the guidelines outlined below appear in the tutorials added to this repo and other pages/files/tools are always welcome as well.

A complete tutorial:

  • contains a README with:
    • what the tutorial is for, potential use cases, and how the tutorial is organized
    • a list of the notebooks and datasets included in the tutorial with clickable links
    • describes how to install the necessary dependencies for running the tutorials
  • is self-contained:
    • meaning that the module itself is sharable and doesn't reference other modules in the repo
    • with the exception of referencing to other tutorials as potential prerequisites or next steps in a learning guide (i.e. "to do the Pandas tutorial, you should first do the Python tutorial" (with a clickable link to the python tutorial))
      • please link these in the README or as you are referencing them

Template Tutorial README

This tutorial is designed to be a starting point for other tutorials in this repo. It is recommended that you clone this tutorial and then use it as a launching point for your tutorial. There are three main components of the tutorial Notebooks, Data, and Slides. In the Data folder are two files. One creating data which saves as a .npy to the which is also stored in the folder. The Notebook folder contains an example Jupyter notebook that analyzes data from the Data folder. Finally the Slides folder contains an example slide show that walks through this tutorial and the source.tex to make your own presentation.

To be able to run through the notebooks in the tutorial first install the requirements using pip install -r requirements.txt After installing the requirements read through the slides, and then go through the notebook.

After completing this tutorial, you should be able to move on to any other tutorial in the repo and also have the skill set needed to make your own tutorial.

Table of contents

  • requirements- List of dependencies for this tutorial, able to be automatically installed via pip.
  • data
  • notebooks- Folder containing Jupyter Notebooks
    • demo- Analyzing the sample data
  • slides
    • slides.txt- Txt format for the slide show- copy and paste into Overleaf as a template to make your own show
    • slides.pdf-Pdf presentation of the tutorial
    • figs- Folder containing figures for the slideshow
      • make figure- Code to make the figure in the slideshow
      • sin- PDF version of slide show figure