Skip to content

Boilerplate for working up data. Integration with OSF storage.

License

Notifications You must be signed in to change notification settings

wright-group/wright-cookiecutter-workup

Repository files navigation

wright-cookiecutter-workup

A cookiecutter template for data analysis. Includes integration with Open Science Framework (OSF) storage. Includes a CLI for figure plotting (using click).

Usage

  1. If your are using OSF, start an OSF repository and establish an ID. You will want this ID before initializing the project. You need not push your data to the OSF repository right away.

  2. Install cookiecutter.
    Using conda: conda install cookiecutter

  3. Initialize the project folder. Using a terminal in the parent folder for your project destination, run

    cookiecutter gh:wright-group/wright-cookiecutter-workup

    and complete the prompts.

  4. The project is now templated. You can begin working up data! Now is also a good time to start a git repository.

Notes on osf data storage

  • To upload data in bulk (a nested folder structure), use osfclient's upload feature with the recursive setting:
    osf -u [username] -p [project_id] upload -r [source] [destination]
    
    You will need to supply our username password upon request (or you can use token authentications as well).
  • The root directory of the remote filesystem is seen as "OSF storage" online; you do not need to include this name when specifying a destination path.
  • build.py fetch will clone the osf directory into ./data/osfstorage. If you alter the contents of the local directory, you can update the remote with the update keyword
    osf -u [username] -p [project_id] upload -r --update ./path/to/osfstorage .
    
  • osfclient's upload feature only works for osf-hosted data; you will have to organize remote folders another way if you host data with an add-on service.

About

Boilerplate for working up data. Integration with OSF storage.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages