Skip to content

Commit

Permalink
Merge pull request #1 from jose-d/main
Browse files Browse the repository at this point in the history
remove multiprocessing from readme, introduce INSTALL.md to formalize what to do to install the code.
  • Loading branch information
ippocratiss authored Sep 30, 2024
2 parents 5244eec + afde2e0 commit 0f02dd3
Show file tree
Hide file tree
Showing 3 changed files with 37 additions and 94 deletions.
36 changes: 36 additions & 0 deletions INSTALL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
# Manual Installation of EMRI_MC using Python venv

## Runtime environment preparation

Python - code was tested with #FIXME! python3.11. Make sure development package for given python version is installed too. Eg. at EL-like linux distros, `dnf install python3.11-devel`.

### Ensure CUDA is present

eg. at cluster environments, load CUDA toolkit. [^1]

```
module load CUDA/12.2.0
```

### Create venv

...and install recent `pip`..

```
python3.11 -m venv ~/.venvs/EMRI_MC
pip install --upgrade pip
```

### Activate venv and install code dependencies

`source ~/.venvs/EMRI_MC/bin/activate`

#WIP, so far exact list of dependencies in unclear.

note: install step `Running setup.py install for cupy ...` can take long time.

`pip install cupy emcee seaborn matplotlib pandas numpy emcee IPython ipykernel scipy h5py`

# Notes

[^1]: CUDA Toolkit - https://developer.nvidia.com/cuda-toolkit
86 changes: 0 additions & 86 deletions README.ipynb

This file was deleted.

9 changes: 1 addition & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,16 +8,9 @@ On top of Python's usual **numpy** and **scipy** libraries, to run the code one

1. **cuda/cupy**: https://nvidia.github.io/cuda-python/install.html



2. **emcee**: https://emcee.readthedocs.io/en/stable/user/install/



3. **multiprocessing**: https://pypi.org/project/multiprocessing/


4. **corner** or **seaborn** or anything similar: https://corner.readthedocs.io/en/latest/install/ https://seaborn.pydata.org/installing.html
3. **corner** or **seaborn** or anything similar: https://corner.readthedocs.io/en/latest/install/ https://seaborn.pydata.org/installing.html

The cuda/cupy library provides the GPU functionality, emcee is the library with the MCMC sampler, multiprocessing is needed for parallelisation, and the corner/seaborn for producing the corner plots.

Expand Down

0 comments on commit 0f02dd3

Please sign in to comment.