PAPI (PANIC Pipeline) is the automatic image processing pipeline for data obtained with the PAnoramic Near Infrared Camera (PANIC) for the 2.2m and 3.5m Telescopes at Calar Alto Observatory (CAHA). The pipeline is written in Python and developed at the Institute of Astrophysics of Andalusia (CSIC). The automated processing steps include basic calibration (removeing instrumental signature), cosmic-ray removal, treatment for electronic ghosts (cross-talk), sky subtraction, non-linear count-rate correction, robust alignment and registration.
Although PAPI was developed for the PANIC camera with H2RG detector, it was updated in 2025 to support the new H4RG detector integrated into PANIC.
PANIC is a general purpose Panoramic Near Infrared camera for Calar Alto. It is optimized for use at the 2.2m telescope, but can also be installed at the 3.5m telescope. It works in the nIR bands Z, J, H and K.
PAPI has the following strict requirements:
- Python 3.7
- Numpy 1.18.x or later
- `Anaconda`_ 2022.05-2024.10
- `IRAF`_ 2.16
and also depends on next packages:
The above packages are automatically included in the Anaconda package, and then you do not need to install them manually. However, next tools need to be installed by the user following the instructions included in each package:
- CDSClient
- SExtractor (> v2.25)
- SCAMP (> v2.10)
- SWarp (> v2.41.5)
- Astrometry.net with 42xx index files
- SAO DS9 and XPA (v8.5)
- Montage (v3.3)
- montage_wrapper (0.9.8)
Note that, for PyRAF_ you have to install IRAF_ (v2.16 or later), what can be a tricky task. However, is has been simplified in recent versions.
The PAPI package can be installed into a virtualenv or Conda (prefered) environment manager via pip. We recommend a fresh environment with only python installed. Via Conda:
Install Anaconda3 (for Python 3.7), which include Conda manager.
Create environment (papienv) and install PyRAF:
$ conda config --add channels http://ssb.stsci.edu/astroconda $ conda create -n papienv python=3.7 iraf-all pyraf-all
Warning
Due to Python 3.x incompatibilities present in several tasks, STScI recommends to install IRAF alongside Python 2.7. However, PAPI is implemented for Python3, and no problems was found by the moment.
After the installation is complete go ahead and activate the “papienv” environment. This command only needs to be executed one time per terminal session:
$ conda activate papienv
Install the tools required by PAPI (TBC, requirements.txt ?):
$ pip install scipy $ pip install montage_wrapper $ conda install -c astropy ccdproc==2
To install a released (tagged) version, you can install directly from Github. To install tagged release papi 2.1.0:
$ pip install git+https://github.com/ppmim/PAPI.git@2.1.0
The latest development version (from master) can also be installed from Github:
$ pip install git+https://github.com/ppmim/PAPI.git
As can a particular commit hash:
$ pip install git+https://github.com/ppmim/PAPI.git@3f03323c
Warning
The script papi_setup.sh is currently implemented only for the Bash shell, and will modify your .bashrc file adding a new line at the end.
- Go to config_files/ directory to setup the config file to use.
Note
If you are behind a proxy, you need to set the proxy in your system:
http_proxy=http//your_proxy:your_port; export http_proxy
Currently PAPI has only be tested under openSuSE15.5 and Ubuntu 24.04, but it should work on any 64-bit Linux box with the software packages required above.
You can browse the latest release documentation online.
Webpage: http://www.iaa.es/PANIC Maintainer: jmiguel@iaa.es