Hi, w.r.t. the original repository this repository is supplemented with:
- Python code and latex report integration. The following is done with a single command:
- Plots are exported directly into your latex report.
- Your python code is automatically included in the appendices of your report.
- The example jupyter notebook is automatically executed.
- The example jupyter notebook is automatically converted to pdf
- The pdf of the example jupyter notebook is automatically integrated in the latex report.
- The latex report is automatically compiled into a pdf.
- You can easily sync with overleaf, e.g. if you do a last minute run, you just push and pull into overleaf, instead of manually uploading pictures.
- Example unit tests are written that test both the python code, as well as the code inside the Jupyter notebooks.
- All unit tests can be ran with a single command.
- The continuous integration with Travis-CI runs all the unit tests in this repository automatically for every push towards this repository ('s master branch). If all tests are passed, the above badge is green and says "passed".
Room for improvement
- The code (that I wrote) could be documented more clearly, with proper comment formatting.
- The code that (executes and) converts the jupyter notebooks to pdf could loop through all notebooks in the respective
/src/
folder automatically in atry
catch
block to automatically skip new notebooks that do not yet compile. This would prevent the user from having to specify which notebooks should be compiled.
- If you don't have pip: open Anaconda prompt and browse to the directory of this readme:
cd /home/<your path to the repository folder>/
- To use this package, first make a new conda environment (it this automatically installs everything you need).
conda env create --file tudat-space_environment.yml
- Activate the conda environment you created:
conda activate tudat-space
- Performe a run for assignment 1 (named project1) of main code (in
main.py
, called from__main__.py
)
python -m code.project1.src
- Testing is as simple as running the following command in the root directory of this repository in Anaconda prompt:
python -m pytest
from the root directory of this project.
The docstring documentation (template) was generated using pyment
. The HTML documentation of the code was
generated using pdoc
.