Welcome to IX-train

A website dedicated to training material for my ICRF.

Cloning the repo

git clone git@github.com:jonathon-langford/ix-train.git
cd ix-train

Bulding the docs

After pushing the changes to main GitHub branch, run the following command:

pip install mkdocs  #If needed
mkdocs gh-deploy

Environment installation

The recommended means for accessing the software environment is using an LCG releave via CVFMS:

. /cvmfs/sft.cern.ch/lcg/views/LCG_106/x86_64-el9-gcc13-opt/setup.sh

If you do not have access to CVFMS (lxplus or IC machines) then you can setup an environment with all relevant packages using micromamba.

First clone the GitHub repo:

git clone git@github.com:jonathon-langford/ix-train.git
cd ix-train

If you have not already installed micromambda then it can be done very simply with:

"${SHELL}" <(curl -L micro.mamba.pm/install.sh)

You will be asekd a serious of questions to determine your preferred setup:

Micromamba binary folder? [~/.local/bin] 
Init shell (bash)? [Y/n] Y
Configure conda-forge? [Y/n] Y
Configure conda-forge? [~/micromamba]

You may want to specify a certain location for the micromambda prefix (last line) as it can take up a reasonably large space. If this is successful you will receive some printout about appending lines to your ~/.bashrc. Make sure to run:

source ~/.bashrc

Test if `micromamba is available by running:

micromamba --version

You can then setup the ix-train environment with:

micromamba env create --prefix /vols/cms/jl2117/icrf/envs/ix-train -f environment.yaml

Replacing the prefix with where you want the environment binaries to be stored. Activate the environment with:

micromamba activate /vols/cms/jl2117/icrf/envs/ix-train