Preparation

Supported Machines and Environments

The current Gen3 2D DRP is supported on CentOS 7 and AlmaLinux 9 (recommended). The PFS 2D DRP pipeline is built upon the LSST pipeline, and requires that be installed. These pipelines use Python 3.11 features; lower python versions (python ≥ 3.9) may be acceptable for using the datamodel package without the pipeline.

The examples below assume use of bash, although the pipeline supports other shells as well.

Support for additional systems may be added in the future.

Setup Directory

---

We assume that the working directory is $WORKDIR/(username)/.

First, we will need to create a folder for necessary dependencies.

$ mkdir $WORKDIR/(username)/bin

Then, to set up the default environment variable, we should add the following line to ~/.bashrc

$ export PATH=$WORKDIR/(username)/bin:$PATH

Install Dependencies

---

Step 1: Fetch a tool of yum

There is a useful tool for installing dependencies in local environments: user-yum. It installs applications conveniently without the root privilege in CentOS 7.

$ cd $WORKDIR/(username)/bin
$ git clone https://gitlab.com/caroff/user-yum.sh.git

You will find it handy if you change Makefile line 40 from INSTALL_FLAG_PREFIX := + to INSTALL_FLAG_PREFIX :=

Then insert the following lines to ~/.bash_profile:

# Setting environment for $WORKDIR/(username)/bin/user-yum.sh/root
ROOT_D="$WORKDIR/(username)/bin/user-yum.sh/root"
export PATH=$ROOT_D/usr/sbin:$ROOT_D/usr/bin:$ROOT_D/bin:$PATH
L="/lib:/lib64:/usr/lib:/usr/lib64"
export LD_LIBRARY_PATH=$L:$ROOT_D/usr/lib:$ROOT_D/usr/lib64:$LD_LIBRARY_PATH

Step 2: Install git LFS

Git LFS must be installed to download large files from Git.

$ cd $WORKDIR/(username)/bin
$ wget https://github.com/git-lfs/git-lfs/releases/download/v3.5.1/git-lfs-linux-amd64-v3.5.1.tar.gz
$ tar xzf git-lfs-linux-amd64-v3.5.1.tar.gz
$ cd git-lfs-3.5.1
$ PREFIX=$WORKDIR/(username) ./install.sh