In a hurry? Quick-start.
Browse repository on GitHub.
Overview
MARTINI is a modular package for the creation of synthetic resolved HI line observations (data cubes) of smoothed-particle hydrodynamics simulations of galaxies. The various aspects of the mock-observing process are divided logically into sub-modules handling the data cube, source, beam, noise, spectral model and SPH kernel. MARTINI is object-oriented: each sub-module provides a class (or classes) which can be configured as desired. For most sub-modules, base classes are provided to allow for straightforward customization. Instances of each sub-module class are given as parameters to the Martini class; a mock observation is then constructed by calling a handful of functions to execute the desired steps in the mock-observing process.
Documentation contents
Citing Martini
If your use of MARTINI leads to a publication, please cite the JOSS paper (ADS listing) and the original paper (also on ADS). You may also cite the MARTINI entry in the ASCL (indexed on ADS). Ideally specify the version used (Zenodo DOI, git commit ID and/or version number) and link to the github repository.
@ARTICLE{2024JOSS....9.6860O,
author = {{Oman}, Kyle A.},
title = "{MARTINI: Mock Array Radio Telescope Interferometry of the Neutral ISM}",
journal = {The Journal of Open Source Software},
keywords = {astronomy, simulations},
year = 2024,
month = jun,
volume = {9},
number = {98},
eid = {6860},
pages = {6860},
doi = {10.21105/joss.06860},
adsurl = {https://ui.adsabs.harvard.edu/abs/2024JOSS....9.6860O},
adsnote = {Provided by the SAO/NASA Astrophysics Data System}
}
@ARTICLE{
2019MNRAS.482..821O,
author = {{Oman}, Kyle A. and {Marasco}, Antonino and {Navarro}, Julio F. and {Frenk}, Carlos S. and {Schaye}, Joop and {Ben{\'\i}tez-Llambay}, Alejandro},
title = "{Non-circular motions and the diversity of dwarf galaxy rotation curves}",
journal = {\mnras},
keywords = {ISM: kinematics and dynamics, galaxies: haloes, galaxies: structure, dark matter, Astrophysics - Astrophysics of Galaxies, Astrophysics - Cosmology and Nongalactic Astrophysics},
year = 2019,
month = jan,
volume = {482},
number = {1},
pages = {821-847},
doi = {10.1093/mnras/sty2687},
archivePrefix = {arXiv},
eprint = {1706.07478},
primaryClass = {astro-ph.GA},
adsurl = {https://ui.adsabs.harvard.edu/abs/2019MNRAS.482..821O},
adsnote = {Provided by the SAO/NASA Astrophysics Data System}
}
@MISC{
2019ascl.soft11005O,
author = {{Oman}, Kyle A.},
title = "{MARTINI: Mock spatially resolved spectral line observations of simulated galaxies}",
keywords = {Software},
howpublished = {Astrophysics Source Code Library, record ascl:1911.005},
year = 2019,
month = nov,
eid = {ascl:1911.005},
pages = {ascl:1911.005},
archivePrefix = {ascl},
eprint = {1911.005},
adsurl = {https://ui.adsabs.harvard.edu/abs/2019ascl.soft11005O},
adsnote = {Provided by the SAO/NASA Astrophysics Data System}
}
Work that has used MARTINI includes: Oman et al. (2019), Mancera Piña et al. (2019), Chauhan et al. (2019), Mancera Piña et al. (2020), Santos-Santos et al. (2020), Glowacki et al. (2021), Bilimogga et al. (2022), Glowacki et al. (2022), Roper et al. (2023), Oman et al. (2024), Elson (2024), Perron-Cormier et al. (2025), Lin et al. (2026), Rabyang & Elson (2026) and Dado et al. (2026). The ALMASim package (Guglielmetti et al. 2023) builds on some of MARTINI’s functionality. If your work has used MARTINI and is not listed here, please let me know (by email or github issue).