NumPy Survey Results
Analysis and publication of the results of the 2020 NumPy Community Survey.
Running the analysis
Several steps are required to analyze and publish the survey results:
- Acquiring the survey data
- Configuring the environment
- Running the analysis & generating the website.
Each of these steps is covered below.
Survey data
Coming soon...
Environment setup
The necessary packages for analyzing and publishing the results are listed in
requirements.txt
and site/requirements.txt
, respectively.
The following procedure can be used to set up an environment for data
analysis:
python -m venv survey_analysis
source survey_analysis/bin/activate
python -m pip install .[publish]
Running the analysis
Sphinx is used to automatically run the analysis via the myst-nb plugin and generate a static website presenting the results:
cd site
make html
The generated site can then be viewed by opening site/_build/html/index.html
in your preferred browser.
Converting to Jupyter notebooks
For those who are more comfortable with Jupyter notebooks, the myst-nb
text-based notebook files can be converted to .ipynb
files:
cd site
make notebooks
This converts all of the .md
files in content/
to .ipynb
files of the
same name and moves them to site/notebooks
.
The notebooks can then be opened for interactive use in the standard way, e.g.
cd site/notebooks
jupyter notebook
Note:
The text-based notebook format includes more features than are currently
supported by traditional Jupyter notebooks.
Therefore, some features (e.g. glue
or other MyST roles & directives) will
not render when interacting with the .ipynb
file.