MultiNEAs

MultiNEAs is a Python package designed to provide numerical tools for studying the dynamics and population of Near-Earth Asteroids (NEAs). The package offers a comprehensive suite of utilities for orbital calculations, statistical analysis, and visualization of NEA populations.

Features

Orbital Dynamics: Tools for computing and analyzing near-earth asteroid orbits.
Population Studies: Statistical methods for studying NEA populations.
Visualization: Plotting and visualization utilities for asteroid data.
Data Management: Efficient handling of asteroid catalogs and databases.

Documentation

Full API documentation is available at https://multineas.readthedocs.io.

Installation

From PyPI

MultiNEAs will be available on PyPI at https://pypi.org/project/multineas/. Once published, you can install it with:

pip install -U multineas

From Sources

You can also install from the GitHub repository:

git clone https://github.com/seap-udea/MultiNEAs
cd MultiNEAs
pip install .

For development, use an editable installation:

cd MultiNEAs
pip install -e .

In Google Colab

If you use Google Colab, you can install MultiNEAs by executing:

!pip install -U multineas

Quick Start

Getting started with MultiNEAs is straightforward. Import the package:

import multineas as mn

NOTE: If you are working in Google Colab, load the matplotlib backend before producing plots:
%matplotlib inline

Examples

Working examples and tutorials will be added as the package develops.

Citation

The numerical tools and codes provided in this package have been developed and tested over several years of scientific research. Several publications have been produced using the code included in this package.

This is a list of the publications where we have tested the code included in this package:

Conditions for visual and high-resolution bistatic radar observations of Apophis in 2029. Agustín Vallejo, Jorge I. Zuluaga, Germán Chaparro Monthly Notices of the Royal Astronomical Society, 518(3), 4438-4448. DOI: 10.1093/mnras/stac3046 | arXiv: 2201.12205
Location, orbit and energy of a meteoroid impacting the moon during the Lunar Eclipse of January 21, 2019. Jorge I. Zuluaga, Matipon Tangmatitham, Pablo A. Cuartas-Restrepo, Jonathan Ospina, Fritz Pichardo, Sergio A. Lopez, Karls Pena, J. Mauricio Gaviria-Posada Monthly Notices of the Royal Astronomical Society, Volume 492, Issue 3, March 2020, Pages 3666–3673 DOI: 10.1093/mnras/stz3531 | arXiv: 1901.09573
Can we predict the impact conditions of metre-sized meteoroids? Jorge I. Zuluaga, Pablo A. Cuartas-Restrepo, Jhonatan Ospina, Mario Sucerquia Monthly Notices of the Royal Astronomical Society: Letters, 486(1), L69-L73. DOI: 10.1093/mnrasl/slz060 | arXiv: 1904.12807
Speed Thresholds for Hyperbolic Meteors: The Case of the 2014 January 8 CNEOS Meteor. Jorge I. Zuluaga Research Notes of the AAS, 3(5), 68. DOI: 10.3847/2515-5172/ab1de3
Towards a theoretical determination of the geographical probability distribution of meteoroid impacts on Earth. Jorge I. Zuluaga, Mario Sucerquia Monthly Notices of the Royal Astronomical Society, 477(2), 1970-1983. DOI: 10.1093/mnras/sty702 | arXiv: 1801.05720
A General Method for Assessing the Origin of Interstellar Small Bodies: The Case of 1I/2017 U1 (‘Oumuamua). Jorge I. Zuluaga, Oscar Sanchez-Hernandez, Mario Sucerquia, Ignacio Ferrin The Astronomical Journal, 155(6), 236. DOI: 10.3847/1538-3881/aabd7c | arXiv: 1711.09397
The orbit of the Chelyabinsk event impactor as reconstructed from amateur and public footage. Jorge I. Zuluaga, Ignacio Ferrin, Stefan Geens arXiv Repository DOI: 10.48550/arXiv.1303.1796 | arXiv: 1303.1796
A preliminary reconstruction of the orbit of the Chelyabinsk Meteoroid. Jorge I. Zuluaga, Ignacio Ferrin arXiv Repository DOI: 10.48550/arXiv.1302.5377 | arXiv: 1302.5377

If you use MultiNEAs in your research, please cite:

@software{multineas2026,
  author = {Zuluaga, Jorge I. and Agudelo, Juanita A.},
  title = {MultiNEAs: Numerical tools for near-earth asteroid dynamics and population},
  year = {2026},
  url = {https://github.com/seap-udea/MultiNEAs}
}

What’s New

For a detailed list of changes and new features, see WHATSNEW.md.

Authors and Licensing

This project is developed by the Solar, Earth and Planetary Physics Group (SEAP) at Universidad de Antioquia, Medellín, Colombia. The main developers are:

Jorge I. Zuluaga - jorge.zuluaga@udea.edu.co
Juanita A. Agudelo - juanita.agudelo@udea.edu.co

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0) - see the LICENSE file for details.

Contributing

We welcome contributions! If you’re interested in contributing to MultiNEAs, please:

Fork the repository
Create a feature branch
Make your changes
Submit a pull request

Please read the CONTRIBUTING.md file for more information.

File attribution

Most of this file was vibe coded by the authors using Gemini 3 Pro in Antigravity.