Visualized Demos for Engineering Mathematics

Developed for AERSP 313 Aerospace Analysis at the Pennsylvania State University.

Under development for Fall 2022.

The Jupyter-based web application is generated using Mercury and hosted on Heroku.

To directly play with Jupyter notebook

Just download the ipynb file and run it on your computer. Make sure to install the Python environment and the Jupyter package. For first-time users, the easiest way to start is to install Anaconda.

Workflow for developers

0. Installation
   • Follow the guide here to install Heroku CLI tools.
   • Then here to install Mercury CLI tools. Make sure mercury is in PATH.
   • Clone the current repo.
1. Develop the Jupyter notebook application locally, with the file in the root path. One can check the web application locally by

   mercury watch <path_to_your_notebook>
   

   To delete the notebook,

   mercury delete <path_to_your_notebook>
   

   If CTRL+C does not kill the Django server, on Mac one can use

   sudo lsof -t -i tcp:8000 | xargs kill -9
   

   If done with the local edits, commit and push to the current repo.
2. If everything looks good, one can push to the Heroku website

   git push heroku <branch_name>
   

   The branch name for the current repo is master, instead of main as suggested by some Mercury documentation.
3. If a library/driver is not available on Heroku, it typically can be added via settings/buildpack of the app.
4. If one is logged out of Heroku CLI, do

heroku auth:login

5. To debug Heroku application, do

Heroku logs --tail

Note:

1. One can ignore the celery-related files - those are only for running Mercury locally.
2. Widgets for Mercury, see here