PlasmaPy Summer School 2024

Example notebooks

Here are links to use the notebooks.

Run tests locally with:

nox -s tests

Build documentation locally at:

nox -s docs

Simplified cartoon of the git and GitHub scheme.

At this point we assume you have already forked this repository and set up your local git repository.

Start by determining which formulary function you would like to add to the repo. You can select from existing formulary functions contained in the plasmapy.formulary or choose one of your own.
Back at your local git clone (on your personal computer) update the main branch. This is the local branch that has its upstream set the main branch of the plasmapy-summer-school repository. This will ensure you are starting from the most up-to-date version of the repository.
Create a working branch from your updated main branch. Name this working branch something explicitly descibing what you are adding. For example, name the working branch add_gyroradius for contributing a formulary function for the gyroradius.
Push an instance of your working branch to your GitHub fork of plasmapy-summer-school.
Now, add the code associated with your formulary function to the appropriate .py file located in the ./src/hack/formulary directory.
- As you develop your code try to make frequent, well focused commits. This is not a strict rule, but will help with debugging errors if, and when, they occur.
Push you commits to GitHub at a regular intervals.
When ready, open a Pull Request (PR) from your working branch on your fork to the main branch on the original repository. For detailed instructions follow GitHub's instructions of Creating a pull request from a fork.