Manual installation

Note: We recommend using Homebrew to install and update COSEDA. Instructions are available for Linux/Windows and MacOS. If you still choose to do a manual installation, the following instructions might be helpful.

If you haven’t installed Conda on your machine yet, let’s download the Miniconda installer first. Open a new Terminal and paste the following line:

curl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh

for Linux/WSL2 (x86) or

curl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-arm64.sh

for MacOS (Apple Silicon)

..and run it. You will be asked to review the license (“Press ENTER to continue”, etc.):

bash Miniconda3-latest-Linux-x86_64.sh

or

bash Miniconda3-latest-MacOSX-arm64.sh

Note: On some systems you’ll need to chmod +x Miniconda3-…sh before running it. Usually you can skip this step.

After the installation is finished, initialize it:

"$HOME/miniconda3/bin/conda" init bash

For the changes to take effect, you now need to close your current shell and open a new one.

Now we can clone the repository:

git clone https://gitlab.com/kristallorakel/coseda.git

And move to the COSEDA directory:

cd coseda

There is already a YAML file in the Repository. Once you run the following line, Conda will create a new environment:

conda env create -f environment.yml

Once this is done, we can activate the environment and install COSEDA:

conda activate coseda && pip install -e .

Congrats, the installation is done. Now you can type “coseda”, hit enter and a new COSEDA window should pop up!

Note: After restarting your shell, you need to activate the environment again by conda activate coseda.

Some of the functions require a CrystFEL installation. You can find installation instructions here.