SpaceKLIP is a data reduction pipeline for JWST high-contrast imaging. All code is currently under heavy development and typically expected features may not be available.

Compatible test data: here

At this stage it is recommended that you clone the Git repository directory for installation:

git clone https://github.com/kammerje/spaceKLIP_new.git

If you would like to install a specific branch:

git clone https://github.com/kammerje/spaceKLIP_new.git@branch

From here, it is highly recommended that you create a unique Anaconda environment to hold all of the spaceKLIP dependencies:

conda create -n spaceklip_new python=3
conda activate spaceklip_new

With the Anaconda environment created, move to the cloned directory and install the dependencies and spaceKLIP itself:

cd where/you/saved/the/git/repo
pip install -r requirements.txt
pip install -e .

Finally, and very importantly, you will need to download the reference files and set the environment variables supporting the functioning of webbpsf and webbpsf_ext. Instructions to do this can be found at the respective package websites (WebbPSF, WebbPSF_ext). Ensure that if you edit your .bashrc file, close and reopen your terminal to fully apply the changes (source ~/.bashrc or source ~/.zshrc may also work).

SpaceKLIP also makes use of the JWST Calibration Reference Data System (CRDS) and you will need to set the corresponding environment variables. Follow the instructions here for bash or zsh: https://jwst-crds.stsci.edu/docs/cmdline_bestrefs/. Note that you do not have to install AstroConda, just set the environment variables (making sure that the CRDS path you set actually exists, i.e., you may need to create the directory).

The current capabilities of the code are summarized below.

database.py

• read_jwst_s012_data: working
• read_jwst_s3_data: working
• print_obs: working
• print_red: working
• update_obs: working
• support for companion fitting: missing

utils.py

• read_obs: working
• write_obs: working
• read_red: working

coron1pipeline.py

• run_obs: working
• custom saturation step: working
• custom reference pixel step: needs updating (side reference pixels not working for subarrays)

coron2pipeline.py

• run_obs: working
• additional outlier detection step: working

coron3pipeline.py

• make_asn_file: working
• run_obs: working

pyklippipeline.py

• run_obs: working
• no absolute PSF alignment, this is now done using the ImageTools library
• no relative frame alignment, this is now done using the ImageTools library
• the old JWST.py is now implemented here

classpsfsubpipeline.py

• run_obs: not working, under development

imagetools.py

• remove_frames: working
• crop_frames: working
• pad_frames: working
• coadd_frames: working
• subtract_median: working
• subtract_background: working
• fix_bad_pixels: working
• replace_nans: working
• align_frames: working (relative frame alignment)
• recenter_frames: working only for TA images (absolute PSF alignment)
• blurring: missing

contrast.py

• raw_contrast: working with pyklippipeline, but does not normalize flux to host star, not working with coron3pipeline since PSF center not being tracked
• need to add throughput map to database and take it into account for raw contrast
• need to add host star model
• need to add calibrated contrast

companion.py

• missing

mast.py

• query_coron_datasets: working