nikamap 1.3

nikamap: a package to manipulate data produced by the IDL NIKA2 pipeline

nikamap is a Python package built around ContMap, a general-purpose class for processing and analysing continuum maps from radio/millimetre observatories. It provides beam handling, match-filtering, point-source detection and photometry, and cutout / simultaneous stacking.

For NIKA2 users, nikamap offers first-class support for the FITS data products of both the IDL and PIIC NIKA2 reduction pipelines through NikaMap and NikaFits, thin subclasses of ContMap that handle multi-band files and scan-level jackknife realisations.

Quick start with generic continuum data

from nikamap import ContMap

cm = ContMap.read('mymap.fits')
cm.plot()

Quick start with NIKA2 data

from nikamap import NikaMap

nm = NikaMap.read('map.fits', band='1mm')
nm.plot()

or using the multi-band container:

from nikamap import NikaFits

data = NikaFits.read('map.fits')
data['1mm'].plot()

Read the documentation on readthedoc.

Features

• reading, slicing, plotting

• match filtering, point source detection and photometry

• powspec spectra estimation

• bootstraping and jackknife

Requirements

You need python 3.10 or later to run nikamap. You will also need numpy, scipy, matplotlib, astropy>=2.0 and photutils>=1.13. The master branch is based on newert photutils API>=1.8, while the tag:0.6 branch follow the old API and python up to 3.8

Installation

nikamap can be installed with

pip install nikamap

But if you prefer to work on the master branch, you can clone the git repository, and install it

git clone https://gitlab.lam.fr/N2CLS/nikamap.git
cd nikamap
pip install -e .

or directly install it from git

pip install git+https://gitlab.lam.fr/N2CLS/nikamap.git

License

This project is licensed under the MIT license.

Contributing

See CONTRIBUTING.rst for the development setup, test commands, documentation build, and contribution expectations.