d`ynasor is hosted on gitlab. The full sources (including this documentation) can be retrieved e.g., via the command line using git
git clone email@example.com:dynasor/dynasor.git
or in the form of a tarball or zip-archive.
dynasor requires Python 2.6/2.7 or higher, numpy, as well as a C99-complient C-compiler. On nix systems, compilation is usually staightforward and merely requires executing the following command on the command line:
./setup.py install --prefix=<build-path>
In case the compilation fails, one should check the settings in the file build_config.py.
After a successful compilation the binary can be found in 1<build-path>/bin` whereas the libraries are located in <build-path>/lib. One now ought to update the PATH environment variable:
as well as the PYTHONPATH variable:
where X.Y denotes the Python version. If dynasor is to used repeatedly it is a good idea to these commands to the .bashrc file (assuming a Bourne again shell).
The present documentation is written in reStructuredText and has been compiled using sphinx. The source files can be found in the doc subdirectory. In order to build the documentation (in html format) locally run
sphinx-apidoc -e -o doc/ dsf/ sphinx-build doc/ userguide/
After successful completion the directory userguide/ will contain the html output files. In order for the compilation to successfully include all components dynasor should have been compiled as described above, including setting the necessary environment variables.
It should be noted that the documentation requires the sphinx extension called sphinxcontrib.bibtex, which can be installed e.g., via pip
pip install sphinxcontrib-bibtex