discminer

The Channel Map Modelling Code

Welcome to the discminer repository! Looking for quick examples and tutorials? Check out the example workflows.
Report a Bug · Request a Feature · Ask a Question

discminer is a Python package for fitting three-dimensional parametric models directly to molecular-line channel maps of protoplanetary discs, then using model–data residuals to reveal their kinematic and intensity substructure.

It enables you to:

Fit intensity and rotation velocity simultaneously across an entire channel-map cube or a selected subset of channels
Model Keplerian rotation, with optional pressure support and disc self-gravity
Reconstruct front- and back-side emitting surfaces and use flexible, non-axisymmetric prescriptions for model attributes
Fit complex line profiles to derive peak-intensity, centroid-velocity, line-width, and line-slope moment maps
Extract rotation curves and radial profiles of intensity, line width, and azimuthal, radial, and vertical velocity
Detect and quantify coherent, localised structures in intensity and velocity residuals

Discminer workflow and capabilities

Mining tools

Discminer offers a wide range of analysis and visualisation tools to fully explore the physical and dynamical structure of discs.

cube

Compute moment maps that accurately capture complex line profile morphologies.
Output moment maps include peak intensity, line width, line slope, and centroid velocity.
Easily clip, downsample, and convert data to brightness temperature units.
Quickly visualise model versus data channels and interactively extract spectra.

rail

Extract azimuthal and radial profiles of intensity, line width, and velocity from moment maps.
Compute rotation curves and decompose disc velocities into their three-dimensional components.
Identify large-scale structures and quantify their pitch angle, width, extent, and degree of coherence.

pick

Identify small-scale perturbations and estimate their degree of localisation.

plottools

Customise intensity channels, moments, and residual maps.
Use sky or disc projections interchangeably for improved visualisation of features.
Easily overlay disc geometry (considering orientation and vertical structure) onto any observable product.
Load in 1D profiles or 2D maps from external data e.g. to highlight the presence of dust substructures.

pca

See the dedicated PCA workflow documentation.

Installation

pip install discminer

To upgrade the code,

pip install -U discminer

Optional dependencies

How to use

You can find practical examples demonstrating the main functionality of the code in the ./example folder of this repository.

To run the examples on your local machine, clone this repository and follow the instructions provided in the README file,

git clone https://github.com/andizq/discminer.git
cd discminer/example/mwc480_12co
less README.rst

Citation

If you find discminer useful for your research please cite the work of Izquierdo et al. 2021,

@ARTICLE{2021A&A...650A.179I,
       author = {{Izquierdo}, A.~F. and {Testi}, L. and {Facchini}, S. and {Rosotti}, G.~P. and {van Dishoeck}, E.~F.},
        title = "{The Disc Miner. I. A statistical framework to detect and quantify kinematical perturbations driven by young planets in discs}",
      journal = {\aap},
     keywords = {planet-disk interactions, planets and satellites: detection, protoplanetary disks, radiative transfer, Astrophysics - Earth and Planetary Astrophysics, Astrophysics - Solar and Stellar Astrophysics},
         year = 2021,
        month = jun,
       volume = {650},
          eid = {A179},
        pages = {A179},
          doi = {10.1051/0004-6361/202140779},
archivePrefix = {arXiv},
       eprint = {2104.09596},
 primaryClass = {astro-ph.EP},
       adsurl = {https://ui.adsabs.harvard.edu/abs/2021A&A...650A.179I},
      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
}

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

discminer-0.5.1.tar.gz (11.5 MB view details)

Uploaded Aug 21, 2026 Source

File details

Details for the file discminer-0.5.1.tar.gz.

File metadata

Download URL: discminer-0.5.1.tar.gz
Upload date: Aug 21, 2026
Size: 11.5 MB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/4.0.2 CPython/3.8.8

File hashes

Hashes for discminer-0.5.1.tar.gz
Algorithm	Hash digest
SHA256	`a3495801ab58d273bdf9c58ca31c4aa145707deb7cc8fbd515aab41d39d97337`
MD5	`0414e0b4d9853c944d46df3f3b908890`
BLAKE2b-256	`bea8fa07ed522f1983c21b106273fb78e4d355a8aa68fd7627d6c440260e904e`