Mermithid is an extension of morpho that contains processors specific to Project 8 analysis, spectrum fitting and plotting.
You will need to install via a package manager (such as apt-get):
- python (3.x; 2.7.x support not guaranteed)
- python-pip
- git
- ROOT (Cern) with pyROOT
These are two possible ways of installing and working with mermithid.
- Cicada and Phylloxera need to be installed in a sub directory:
mkdir build
cd build
cmake ..
make -j3
make -j3 install- These libraries need to be added to your PYTHONPATH:
echo "export PYTHONPATH=${PWD}/build:$PYTHONPATH" >> ~/.bash_profile- Install mermithid:
pip install . -e ./morpho(The -e ./morpho is here to install morpho as an egg.)
Docker provides a uniform test bed for development and bug testing. Please use this environment to testing/resolving bugs.
- Install Docker (Desktop version): https://docs.docker.com/engine/installation/
- Clone and pull the latest master version of mermithid
- Inside the mermithid folder, execute
docker-compose run mermithid. The container prompter should appear at the end of the installation. A directory (mermithid_share) should be created in your home and mounted under the/hostfolder: you can modify this by editing the docker-compose file. - When reinstalling, you can remove the image using
docker rmi mermithid_mermithid
In both cases, you need to set the paths right for using these software. For example in the docker container:
source $MERMITHID_BUILD_PREFIX/setup.sh
source $MERMITHID_BUILD_PREFIX/bin/this_cicada.sh
source $MERMITHID_BUILD_PREFIX/bin/this_phylloxera.shMermithid works a-la morpho, where the operations on data are defined using processors. Each processor should be defined with a name, then should have its attributes configured using a dictionary before being run. Examples of how to use mermithid can be found in the "tests" folder.