Skip to main content

MosaicQueen

A package with mosaicking commands from montage, that also does primary-beam correction for both 2D and 3D images. Originally written to be used by stimela (https://github.com/SpheMakh/Stimela) and, ultimately, CARACal (https://github.com/caracal-pipeline/caracal) for automated radio-data reduction, but it also works independently.

Installation

First install montage via

sudo apt install montage

Package is available on PyPI (https://pypi.org/project/mosaic-queen) and so it is installable via

pip install mosaic-queen

Work in progress: convolution of input images to a common synthesised beam before mosaicking, and employing parallel processing to speed this up…

Usage

usage: mosaic-queen [-h] -i INPUT -t TARGET_IMAGES [TARGET_IMAGES ...]
                  -o OUTPUT -n NAME
                  [-j NUM_WORKERS]
                  [-a {mask,model,residual} [{mask,model,residual} ...]]
                  [-r] [-f] [-bc BEAM_CUTOFF] [-mc MOSAIC_CUTOFF] [-u]
                  [-s {mad,rms,fit}] [-g GUESS_STD] [-ra RA] [-dec DEC]
                  [-v VELOCITY] [-dra DRA] [-ddec DDEC] [-dv DV]

Run make_mosaic over the targets

optional arguments:
-h, --help            show this help message and exit
-i INPUT, --input INPUT
                      The directory that contains the (2D or 3D) images and
                      beams.
-t TARGET_IMAGES [TARGET_IMAGES ...], --target-images TARGET_IMAGES [TARGET_IMAGES ...]
                      Space-separated list of images to be mosaicked. The
                      file names must end with 'image.fits', and this is
                      automatically replaced by 'pb.fits' to locate the
                      corresponding beams (which are also required as input).
-o OUTPUT, --output OUTPUT
                      The directory for all output files.
-n NAME, --name NAME  The prefix to be used for output files.
-j NUM_WORKERS, --num-workers NUM_WORKERS
                      Number of worker threads. Default=0 means all
                      available threads.
-a {mask,model,residual} [{mask,model,residual} ...], --associated-mosaics
                      {mask,model,residual} [{mask,model,residual} ...]
                      Also make mosaics of the associated .fits files,
                      selecting any of 'mask', 'model' and 'residual'. Users
                      should give their choice as a space-separated list.
                      The defult is to not make any associated mosaics.
-r, --regrid          Use montage for regridding the images and beams. Also
                      regrid the 'mask', 'model' and/or 'residual' files,
                      if '--associated-mosaics' is enabled.
-f, --force-regrid    If the user wants newly-regridded files, this argument
                      should be enabled.(If '--regrid' is enabled instead,
                      the package will first check whether regridded files
                      already exist.If they are found, regridding will not
                      proceed because this is a time-consuming step.)
-bc BEAM_CUTOFF, --beam-cutoff BEAM_CUTOFF
                      The cutoff in the primary beam to use.E.g. The default
                      of 0.1 means going down to the 10 percent level for
                      each pointing. Set to zero for no primary beam cutoff.
-mc MOSAIC_CUTOFF, --mosaic-cutoff MOSAIC_CUTOFF
                      Sensitivity cutoff in the final mosaic. Pixels with
                      a noise level > minimum mosaic noise / cutoff are
                      blanked in all final products. E.g. The default of
                      0.2 means blanking in the mosaic all pixels with a
                      noise level > 5x the minimum mosaic noise level. Set
                      to zero for no cutoff (but some cutoff may still
                      result from the -bc setting).
-u, --unity-weights   Build the mosaic using weight=1 instead of
                      weight=1/noise**2 for the input images.
-s {mad,rms,fit,exptime}, --statistic {mad,rms,fit,exptime}
                      State 'mad' (median absolute deviation), 'rms' (root mean
                      square), 'fit' (Gaussian fit) or 'exptime' (exposure time)
                      as the statistic to be used for estimating the noise level
                      in the input images. If selected, the exposure time is
                      taken from the header key 'EXPTIME' and the noise is set to
                      1./sqrt(exptime). In all other cases the noise is derived
                      using the negative pixel-values. The noise levels set the
                      weights=1/noise**2 used when mosaicking. Not used if the '-u'
                      option is enabled. The default is 'mad'.
-g GUESS_STD, --guess-std GUESS_STD
                      An initial guess of the noise level in the input
                      images, if user has set '--statistic' to 'fit'.(This
                      is to aid a Gaussian fit to the negative pixel-values.)
                      The default of 0.02 assumes that the pixel values are
                      in units of Jy/beam, so a std of ~ 20 mJy/beam).
-ra RA                Central RA (in degrees) of the output mosaic image/cube,
                      if the user does not want to image the entire FoV
                      covered by the input images/cubes.
-dec DEC              Central Dec (in degrees) of the output mosaic image/cube,
                      if the user does not want to image the entire FoV
                      covered by the input images/cubes.
-v VELOCITY, --velocity VELOCITY
                      Central velocity/frequency of the output mosaic cube
                      (in the appropriate units of the input cubes) if the
                      user does not want to image the entire velocity/frequency
                      range covered by the input cubes.
-dra DRA              RA range of the output mosaic image/cube (in degrees),
                      if the user does not want to image the entire FoV
                      covered by the input images/cubes.
-ddec DDEC            Dec range of the output mosaic image/cube (in degrees),
                      if the user does not want to image the entire FoV
                      covered by the input images/cubes.
-dv DV                Velocity/frequency range of the output mosaic cube
                      (in the unit used by the input images), if the user
                      does not want to image the entire velocity/frequency
                      range covered by the input cubes.

Metadata

Release files for mosaic-queen 2.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mosaic-queen 2.0.2
File Size Uploaded Provenance Actions
mosaic_queen-2.0.2.tar.gz 30.2 kB Without provenance Details for mosaic_queen-2.0.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mosaic-queen 2.0.2
File Interpreter ABI Platform Actions
mosaic_queen-2.0.2-py3-none-any.whl Python 3 none any Details for mosaic_queen-2.0.2-py3-none-any.whl

Total release size: 61.1 kB

Release files / mosaic_queen-2.0.2.tar.gz

Download URL mosaic_queen-2.0.2.tar.gz
Size 30.2 kB
Tags Source
SHA-256 checksum
How to use checksums
a496a66ff223253528bdce7ebcddb77b6fce91ca72d23f915cdacb8607760977
BLAKE2b-256 checksum
How to use checksums
a771c49b1b92d5d0c6cff798b6848c20e9432ae38b96b99f4cc6cc6ac3805052
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.9.23

Release files / mosaic_queen-2.0.2-py3-none-any.whl

Download URL mosaic_queen-2.0.2-py3-none-any.whl
Size 30.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7ecd12ada7acf96560b4bc6949060856a6e6c591f7e2fbbbcd801f2050da3362
BLAKE2b-256 checksum
How to use checksums
b7616d32197efd56631041538bac936ff449c8d57665a30b5f4f756f7025977e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.9.23

Security for mosaic-queen 2.0.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page