Developer info

We aim for 100% test coverage and 100% documentation coverage. We are not there yet, but any new code must have corresponding test.

Do not commit code which doesn’t pass thorough testing below!!

Installing package locally

To be able to see the effects of localy modified package code you should install it by issuing

pip install -e .

in the directory where setup.py resides. This will install the package in your local Python’s site-packages, but only as a link to the gepard src dir, so any changes to sources will be immediately visible.

Testing and benchmarking

Fast testing the code:

pytest -q

Testing the doctests only:

pytest -q --doctest-glob="*.rst"  --ignore-glob="*.py"

Thorough testing everything

pytest -q --runslow --doctest-glob="*.rst"

Checking test coverage

pytest -q --runslow --cov

Speed-benchmarking the code

pytest -v --runslow tests/fit_test.py::test_gepardfitDVCSnlso3_lo_long

This took about 15 seconds on my machine on old hybrid Fortran/Python gepard with paralelization. Now it takes about 30 seconds on this new pure Python code, without paralelization! (By the way, to parallelize present Python code, one should maybe just switch from einsum to dot for numpy array summations, and use proper version of numpy.)

Code style

Stick to google conventions, especially for docstrings.

I use flake8, pydocstyle and mypy Python linters for the actual code.

Fixed global parameters, like proton mass Mp, or QCD constants Nc, CF, etc. can be capitalized, but for model parameters we consistently use small initial letter.

If variable corresponds to a squared quantity, like mass squared Mp2, this is signfied by 2 at the very end of the variable name. Not somewhere in the middle, and not by sq.

Building this documentation site

The core Gepard code documentation is built automatically from the comments in the code and some structured documentation pages that can be found in the docs subdirectory of the Gepard source git repository.

The complete Gepard site (the one you are reading now) , has some additional documentation about available datasets, publications and GPD server. These additions are covered by separate git repository gepard-site and README there explains how to build the whole site.