If a static view of the FMP notebooks is enough for you, the exported HTML versions can be used right away without any installation. All material including the explanations, the figures, and the audio examples can be accessed by just following the HTML links. If you want to execute the Python code cells, you have to download the notebooks (along with the data), create an environment, and start a Jupyter server. You then need to follow the IPYNB links within the Jupyter session. In the following, we explain the following four steps in detail:
Further information can also be found in the FMP notebook on installing Python packages and using environment files.
The FMP notebooks along with all data are contained in a single zip-compressed archive. You can find this archive at
Decompress the archive and store it on your local computer.
Conda is an open source package manager that helps finding and installing packages. It runs on Windows, macOS and Linux. The Conda package and environment manager is included in Anaconda and its slim version Miniconda, which are free and open-source distributions of Python. Miniconda can make installing Python quick and easy even for new users. Download and install Miniconda for your platform from the following website:
We provide an environment file with all packages needed for interacting with the FMP notebooks. Open the Anaconda Prompt on Windows or your default shell on Linux/macOS. Then change to the directory that contains the file
environment.yml. Create the environment with the following command:
After creating the FMP environment, you need to activate the environment using the following command:
Finally, one needs to change to the directory containing the FMP notebooks and to start the Jupyter server by using the following command:
This should open a browser, displaying the folder structure of the FMP notebooks. You then can open the overview notebook by selecting the file
C0/C0.ipynb. You can also directly open any FMP notebook by selecting a file in any subdirectory with the file extension
.ipynb. Within the Jupyter session you need to follow the IPYNB links to keep the code cells executable. Furthermore note that, within the Jupyter session, you can only access files that are contained in the directory you used for launching the Jupyter server or in any subdirectory.
Here is a list of useful commands, which may be helpful when updating and starting the environment. The command will be explained in more detail in subsequent notebooks.