Common Project Development Procedures

Disclaimer: The following has only been tested on Linux systems.

Setting up Development Environment for Pybind11

1. Install Anaconda on your system by following this link.

2. Upon first use, you might see that your shell may already be in the (base) environment for conda. You can exit the env by issuing conda deactivate

3. Create a Conda environment and enter it:

$ conda create --name uwmro_instruments python=3.10.0
$ conda activate uwmro_instruments

• The python after inputting the name of the environment is to ensure no other packages other than the default are installed.
• As of 01/22/2022, the version of python should be Python 3.10.0.

4a. Make sure you are in the Instruments/ root directory, and issue these commands to install the packages in the environment:

(uwmro_instruments) $ cd Instruments/
(uwmro_instruments) $ conda env create --file conda-requirements.txt

See the Conda Cheat Sheet.

4b. Alternatively, install these packages via Conda (with uwmro_instruments activated):

(uwmro_instruments) $ conda install -c conda-forge libstdcxx-ng pybind11 numpy pytest astropy pillow

5. For copyright reasons, the SDK for the Andor Camera is not publicly available. However, if you were to have the software, to install the software dependencies on your system, open the folder for the software and run

$ sudo ./install_andor

Building the Pybind11 .so Objects

1. Every time you would like to test changes made to andor_wrapper.cpp, or you are building for the first time since cloning the repo, issue the following shell commands:

$ cd Instruments/evora/andor/
$ make clean
$ make andor_wrapper