Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
installation_nmma [2022/02/01 10:17]
theoastro 		installation_nmma [2023/06/10 18:51] (current)
theoastro
Line 1: Line 1:
 ===== Installation ===== ===== Installation =====
  
-=== Setting up a virtual environment (Optional) ===+For the installation of NMMA on smaller servers (e.g. our Uni Potsdam machines) a conda environment can be used for installation, while for larger cluster such as HAWK or Supermuc, a python virtual-environment is the better way to install NMMA. The main reason for the latter is that the mpi4py python package installed within a conda environment can be incompatible with default modules given by a specific cluster.
  
-While it is not strictly necessary, it reduces possible conflicts if one installs python packages that do not need to be available system-wide into local, virtual environments. An easy option to setup such virtual environments is the [[https://docs.python.org/3/library/venv.html#module-venv|venv]] module.+=== Installation on Uni Potsdam machines ===
  
 +Here, we use a [[https://docs.conda.io/en/latest/miniconda.html#| mini conda environment]], in which separate virtual environments can be created with:
 +  conda create --name <name_of_env> python=3.8
 +For the conda environment creation, make sure to use python=3.8 as all dependencies of all included packages work best with this python version. 
 +
 +In order to activate the conda environment, you can use:
 +  conda activate <name_of_env>
 +
 +In order to allow python programs to exploit multiple processors, the [[https://mpi4py.readthedocs.io/en/stable/#| mpi4py]] package needs to be installed first using 
 +  conda install mpi4py
 +
 +NMMA can be source cloned from the git repo with the following command:
 +  git clone https://github.com/nuclear-multimessenger-astronomy/nmma.git
 +
 +We change into the cloned NMMA directory and pip install it using:
 +  pip install -r requirements.txt
 +  pip install .
 +
 +=== Installation on Super-Computer Clusters (e.g. Supermuc) ===
 +For larger computer clusters, a virtual python-based environment is recommended which can be created using:
   python3 -m venv /path/to/new/virtual/environment   python3 -m venv /path/to/new/virtual/environment
  
Line 10: Line 29:
   source /path/to/new/virtual/environment/bin/activate   source /path/to/new/virtual/environment/bin/activate
  
-Another way is to install a [[https://docs.conda.io/en/latest/miniconda.html#| mini conda environment]], in which separate virtual environments can be created with: +With activated virtual environment, we now install **mpi4py** this time with pip: 
-conda create --name <name> python=<version>+  pip install mpi4py 
  
-=== Cloning and installation ===+If this is done, all the other steps can be taken from the installation version explained above, meaning source cloning NMMA and pip installing it with potential on-top installations explained below.
  
-Either within your virtual environment or system-wide, the easiest way to install  [[https://gwemlightcurves.github.io/|gwemlightcurve]] is it to run+=== Optional on-top installations (applicable for both installation versions) === 
 +Some further installations (use-case dependent) might be needed. For GRB based analyses make sure to install 
 +  pip install afterglowpy 
 +For using tensorflow-based interpolation during an inference make sure to install 
 +  pip install imgaug==0.2.6 
 +  pip install tensorflow-cpu 
  
Last modified: le 2022/02/01 10:17

Page Tools