diff options
| author | Gabriel Kosmacher <73120774+kennykos@users.noreply.github.com> | 2023-03-10 13:24:32 -0600 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2023-03-10 13:24:32 -0600 |
| commit | b99a8f2e5e0e77f5a05c93d0b27bb79ac7b48896 (patch) | |
| tree | b83c11e0ab0d15b37f0b739d8716800022f334a3 /README.md | |
| parent | 4e03f54aa1f4e7648b3d3498bc1f173106c10334 (diff) | |
| parent | 2d7b47b8f44b52d21e8df9ca1bce2c5cbd998944 (diff) | |
Merge pull request #1 from kennykos/2-set-up-binder-1
2 set up binder 1
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 28 |
1 files changed, 19 insertions, 9 deletions
@@ -1,19 +1,29 @@ +[](https://github.com/kennykos/toriis-analysis/actions/workflows/analysis-notebook-test-binder.yml) # toriis-analysis -Repository for scripts to evaluate public institutional investment data. +Repository for scripts to evaluate public institutional investment data. These scripts are designed to be launched with [binder](https://mybinder.org/) so that other community members can run their own analyses without any additional setup. + + + +[](https://mybinder.org/v2/gh/toriis-portal/toriis-analysis/HEAD) # Running existing notebook -1) - + Fork + clone repo - + Run `setup/setup.sh` to set up the local conda environment +1. **Interactive, UI-only:** Launch the repo in binder and clone one of the example notebooks +1. **Interactive, CLI only:** + 1. Fork + clone repo + 1. Run `setup/setup.sh` to set up the local conda environment - you may need to install the correct version of miniconda - + Start a local notebook suerver (`juypter notebook`) + 1. Start a local notebook suerver (`juypter notebook`) # Contributing You are welcome to contribute data and analysis results. Please make sure that you contribute **cleared notebooks** so version control capabilities work well. To clear a notebook, use `Kernel -> Researt & Clear Output)` -1) **CLI:** - + Create a new branch (`$ git checkout -b <branch_name>`) - + Commit the new notebook/data (`$ git add <new file>; git commit`) - + Push and generate a pull request +1. **UI-only:** + 1. Download the notebook (Download -> ipynb) + 1. Upload the notebook using the GitHub UI (Upload Files, next to Clone or Download) +1. **CLI only:** Follow the [instructions on github](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) - i.e. + 1. Create a new branch (e.g. `$ git checkout -b`) + 1. Commit the new notebook (e.g. `$ git add` and `$ git commit`) + 1. Push and generate pull request + |