Skip to content

mdpetters/Atmospheric-Physics-Notebooks

Repository files navigation

Atmospheric-Physics-Notebooks

Applets for students to playfully interact with physical relationships and atmospheric models in an inquiry-based course on Atmospheric Physics.

Documentation Docker Image References
Link to Documentation Docker DOI

Installation

Users that want to play with notebooks and are unfamilliar with the Julia language are strongly advised to start with the Docker version. It simplifies the installation due to a significant number of dependencies needed for native installs. It also addresses just-in-time (JIT) compilation lag. (The first time you run a block of code in Julia it will be slow. The second time it will be fast. The Docker version comes with an optimized system image, which has a much reduced JIT lag.) The Docker container can also be used to prototype new material, which can later be incorporated into future versions.

Install the docker engine. Then run the notebooks using the following command:

docker run -it -p 8888:8888 mdpetters/atmospheric-physics-notebooks:v2008

This will download the container (~3GB) and exectute the container. It only needs to be downloaded once. Running the command will produce an http link similar to this one:

http://127.0.0.1:8888/?token=93b5e33a61654afded5f692325ac43f5c73eb6c58435196f

Note that the token is unique to each instance of the container. Follow the your link and open one of the notebooks, e.g.:

Module 01 - Aerosol Dynamics/Module 01 - Aerosol Dynamics.ipynb

Use the menu item "Cell"->"Run All Below" to execute all cells. Navigate back to the beginning and work through the notebook.

Documentation

The documentation includes instructions for local installation.

Link to DocumentationDetailed documentation of version v2008 in HTML format.

Project Status

The Docker image can be run on Linux, maxOS, or Windows. The current version of the project is being developed for Julia 1.4 and above on Linux. It very likely works on native macOS and Windows Julia installs. The versioning scheme is vYYMM, where YY is the year and MM is the month. Major version updates are expected once per year.

Contribute

Contributions including new revisions, correction, or new ideas for notebooks are welcome.

About

Applets for students to playfully interact with physical relationships and atmospheric models in an inquiry-based course on Atmospheric Physics.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published