Metadata-Version: 2.4
Name: multineas
Version: 0.2.17
Summary: MultiNEAs: Numerical tools for near-earth asteroid dynamics and population
Home-page: https://github.com/seap-udea/MultiNEAs
Author: Jorge I. Zuluaga, Juanita A. Agudelo
Author-email: jorge.zuluaga@udea.edu.co, juanita.agudelo@udea.edu.co
License: AGPL-3.0-only
Keywords: astronomy asteroids near-earth-asteroids dynamics celestial-mechanics
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Astronomy
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.20.0
Requires-Dist: scipy>=1.7.0
Requires-Dist: matplotlib>=3.3.0
Requires-Dist: spiceypy>=5.0.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# MultiNEAs

[![version](https://img.shields.io/pypi/v/multineas?color=blue)](https://pypi.org/project/multineas/)
[![downloads](https://img.shields.io/pypi/dw/multineas)](https://pypi.org/project/multineas/)
[![license](https://img.shields.io/pypi/l/multineas)](https://pypi.org/project/multineas/)
[![pythonver](https://img.shields.io/pypi/pyversions/multineas)](https://pypi.org/project/multineas/)
[![Powered by SpiceyPy](https://img.shields.io/badge/Powered%20by-SpiceyPy-blue)](https://github.com/AndrewAnnex/SpiceyPy)

<p></p>
<div align="center">
  <a href="https://multineas.readthedocs.io/">
  <img src="https://raw.githubusercontent.com/seap-udea/MultiNEAs/master/docs/MultiNEAs-logo.webp" alt="MultiNEAs Logo" width="600"/>
  </a>
</div>
<p></p>

`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

## Installation

### From PyPI

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

```bash
pip install -U multineas
```

### From Sources

You can also install from the [GitHub repository](https://github.com/seap-udea/MultiNEAs):

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

For development, use an editable installation:

```bash
cd MultiNEAs
pip install -e .
```

### In Google Colab

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

```python
!pip install -U multineas
```

## Quick Start

Getting started with `MultiNEAs` is straightforward. Import the package:

```python
import multineas as mn
```

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

## Documentation

Full API documentation will be available soon.

## Examples

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

## Contributing

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

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

## Citation

If you use `MultiNEAs` in your research, please cite:

```bibtex
@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}
}
```

## License

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

## Authors

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

## Acknowledgments

This package is being developed at the Solar, Earth and Planetary Physics Group (SEAP) at Universidad de Antioquia, Medellín, Colombia.

## What's New

For a detailed list of changes and new features, see [WHATSNEW.md](WHATSNEW.md).

## File attribution

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

---

MultiNEAs (C) 2026 - Jorge I. Zuluaga and Juanita A. Agudelo
