Getting iDEA

Installation requirements

• Python 3.3 or later
• numpy 1.10 or later
• scipy 0.17 or later
• Cython 0.22 or later
• (optional) matplotlib 1.4 or later for post-processing

Installing iDEA

# Clone from the central repository
git clone https://github.com/godby-group/idea-public.git idea-public

# Install & compile iDEA for your unix user
# (including packages for generating the documentation)
cd idea-public
pip install --user -e .[doc]

# Run example calculation
python run.py

Updating iDEA

# Pull all changes from central git repository
git pull origin master

# Remove the compiled cython modules
python setup.py clean --all

# Recompile the cython modules
python setup.py build_ext --inplace

Generating the documentation

A recent version of the documentation can be found on the iDEA web page. If you are making changes to the code and/or the documentation, you may need to generate the documentation by yourself:

cd doc
bash make_doc.sh
# find html documentation in _build/html/index.html
# find test coverage report in _build/coverage/index.html

Besides HTML, the iDEA documentation can also be compiled as a pdf. If you have a LaTeX distribution installed on your system, simply do:

cd doc
make latexpdf