# MultiREx
## Planetary spectra generator
<!-- This are visual tags that you may add to your package at the beginning with useful information on your package -->
[![version](https://img.shields.io/pypi/v/multirex?color=blue)](https://pypi.org/project/multirex/)
[![downloads](https://img.shields.io/pypi/dw/multirex)](https://pypi.org/project/multirex/)
## Download and install
Describe here how the package can be downloaded and install it in
different arquitectures.
If you are using `PyPI` installation it's as simple as:
```
pip install multirex
```
## Descripción
MultiREx es una biblioteca en Python diseñada para la generación de espectros sintéticos de exoplanetas. Esta herramienta extiende las funcionalidades de la librería Taurex, reorganizando y permitiendo la generación masiva de espectros y observaciones con ruido.
## Taurex
MultiREx se basa en las capacidades de cálculo de espectros y la estructura base de [Taurex](https://taurex3-public.readthedocs.io/en/latest/index.html). Si utilizas `MultiREx` en tu investigación o publicaciones, por favor cita a Taurex de la siguiente manera:
TauREx III: A fast, dynamic and extendable framework for retrievals
A. F. Al-Refaie, Q. Changeat, I.P. Waldmann, y G. Tinetti
ApJ, presentado en 2019
Por este motivo es necesario cargar las opaciedades o secciones eficaces de las moléculas a utilizar en los formatos que TauREx utiliza, los cuales pueden ser obtenidos en :
- [ExoMol](https://www.exomol.com/data/search/).
- [ExoTransmit](https://github.com/elizakempton/Exo_Transmit/tree/master/Opac).
## Características Principales de MultiREx
- **Ensamblaje de Sistemas Planetarios**: Facilita la combinación de diferentes planetas, estrellas y atmósferas para explorar una variedad de configuraciones de sistemas estelares.
- **Atmósferas Personalizables**: Permite la adición y configuración de composiciones atmosféricas variadas para los planetas.
- **Generación de Espectros Sintéticos**: Produce espectros realistas basados en los atributos y condiciones de los sistemas planetarios.
- **Simulación de Observaciones Astronómicas**: Incluye `randinstrument` para simular observaciones de espectros con niveles de ruido determinados por la relación señal-ruido (SNR).
- **Función `explore_multiverse`**: Automatiza la generación de múltiples espectros que varían aleatoriamente en parámetros específicos, proporcionando un amplio rango de resultados para análisis.
## Uso Básico
Aquí un ejemplo simple de cómo usar MultiREx para crear un planeta y generar un espectro sintético:
```python
import mutirex as mrex
# Crear un planeta con propiedades específicas
trappis1e = mrex.Planet(albedo=0.3, radius=0.920, mass=0.692)
trappis1e.set_atmosphere(mrex.Atmosphere(temperature=289, base_pressure=1e5,
top_pressure=1e-3,
composition={"H2O": 1e-2, "CO2": 1e-1, "CH4": (1e-10, 1e-1),
"O3": (1e-10, 1e-1)}, fill_gas="N2"))
# Configurar una estrella
trappist1 = mrex.Star(temperature=2566, radius=0.1192, mass=0.1192)
# Crear un sistema que incluye el planeta y la estrella
systemtrappist1 = mrex.System(trappis1e, trappist1, distance_parsecs=12.42988,
planet_distance=0.02925, orbital_period=6.1010,
transit_time=0.9293/60/60)
# Iniciar el modelo de transmision
systemtrappist1.make_transmission_model()
# Uso de explore_multiverse para generar datos
systemtrappist1.explore_multiverse(wn_grid=wn_grid, snr=3, path=path, n_iter=10,
labels=[["O3"],["CH4"]], header=True, n_observations=1,
spectrum=True, observations=True)
```
En este ejemplo, explore_multiverse se utiliza para generar 10 conjuntos diferentes de espectros y observaciones del sistema systemtrappist1, variando las condiciones de cada conjunto y guardando los resultados en el directorio especificado.
## What's new
If your package will be frequently updated with new features include a
section describing the new features added to it:
Version 0.1.*:
- First version of the package.
------------
This package has been designed and written by David Duque-Castaño and Jorge I. Zuluaga (C) 2023
Raw data
{
"_id": null,
"home_page": "https://pypi.org/project/multirex",
"name": "multirex",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "exoplanets astrobiology astronomy spectroscopy",
"author": "David Duque-Casta\u00f1o and Jorge I. Zuluaga",
"author_email": "dsantiago.duque@udea.edu.co",
"download_url": "https://files.pythonhosted.org/packages/f0/ca/671833d12918421d5d6f897c19081c3abf0e5d4a2ff52c201d5702f28c27/multirex-0.1.5.tar.gz",
"platform": null,
"description": "# MultiREx\n## Planetary spectra generator\n\n\n<!-- This are visual tags that you may add to your package at the beginning with useful information on your package --> \n[![version](https://img.shields.io/pypi/v/multirex?color=blue)](https://pypi.org/project/multirex/)\n[![downloads](https://img.shields.io/pypi/dw/multirex)](https://pypi.org/project/multirex/)\n\n\n## Download and install\n\nDescribe here how the package can be downloaded and install it in\ndifferent arquitectures.\n\nIf you are using `PyPI` installation it's as simple as:\n\n```\npip install multirex\n```\n\n\n## Descripci\u00f3n\nMultiREx es una biblioteca en Python dise\u00f1ada para la generaci\u00f3n de espectros sint\u00e9ticos de exoplanetas. Esta herramienta extiende las funcionalidades de la librer\u00eda Taurex, reorganizando y permitiendo la generaci\u00f3n masiva de espectros y observaciones con ruido.\n\n## Taurex\nMultiREx se basa en las capacidades de c\u00e1lculo de espectros y la estructura base de [Taurex](https://taurex3-public.readthedocs.io/en/latest/index.html). Si utilizas `MultiREx` en tu investigaci\u00f3n o publicaciones, por favor cita a Taurex de la siguiente manera:\n\nTauREx III: A fast, dynamic and extendable framework for retrievals\nA. F. Al-Refaie, Q. Changeat, I.P. Waldmann, y G. Tinetti\nApJ, presentado en 2019\n\nPor este motivo es necesario cargar las opaciedades o secciones eficaces de las mol\u00e9culas a utilizar en los formatos que TauREx utiliza, los cuales pueden ser obtenidos en :\n- [ExoMol](https://www.exomol.com/data/search/).\n- [ExoTransmit](https://github.com/elizakempton/Exo_Transmit/tree/master/Opac).\n\n\n\n## Caracter\u00edsticas Principales de MultiREx\n\n- **Ensamblaje de Sistemas Planetarios**: Facilita la combinaci\u00f3n de diferentes planetas, estrellas y atm\u00f3sferas para explorar una variedad de configuraciones de sistemas estelares.\n- **Atm\u00f3sferas Personalizables**: Permite la adici\u00f3n y configuraci\u00f3n de composiciones atmosf\u00e9ricas variadas para los planetas.\n- **Generaci\u00f3n de Espectros Sint\u00e9ticos**: Produce espectros realistas basados en los atributos y condiciones de los sistemas planetarios.\n- **Simulaci\u00f3n de Observaciones Astron\u00f3micas**: Incluye `randinstrument` para simular observaciones de espectros con niveles de ruido determinados por la relaci\u00f3n se\u00f1al-ruido (SNR).\n- **Funci\u00f3n `explore_multiverse`**: Automatiza la generaci\u00f3n de m\u00faltiples espectros que var\u00edan aleatoriamente en par\u00e1metros espec\u00edficos, proporcionando un amplio rango de resultados para an\u00e1lisis.\n\n## Uso B\u00e1sico\nAqu\u00ed un ejemplo simple de c\u00f3mo usar MultiREx para crear un planeta y generar un espectro sint\u00e9tico:\n\n```python\nimport mutirex as mrex\n\n# Crear un planeta con propiedades espec\u00edficas\ntrappis1e = mrex.Planet(albedo=0.3, radius=0.920, mass=0.692)\ntrappis1e.set_atmosphere(mrex.Atmosphere(temperature=289, base_pressure=1e5,\n top_pressure=1e-3,\n composition={\"H2O\": 1e-2, \"CO2\": 1e-1, \"CH4\": (1e-10, 1e-1),\n \"O3\": (1e-10, 1e-1)}, fill_gas=\"N2\"))\n\n# Configurar una estrella\ntrappist1 = mrex.Star(temperature=2566, radius=0.1192, mass=0.1192)\n\n# Crear un sistema que incluye el planeta y la estrella\nsystemtrappist1 = mrex.System(trappis1e, trappist1, distance_parsecs=12.42988,\n planet_distance=0.02925, orbital_period=6.1010,\n transit_time=0.9293/60/60)\n# Iniciar el modelo de transmision\n\nsystemtrappist1.make_transmission_model()\n\n# Uso de explore_multiverse para generar datos\nsystemtrappist1.explore_multiverse(wn_grid=wn_grid, snr=3, path=path, n_iter=10,\n labels=[[\"O3\"],[\"CH4\"]], header=True, n_observations=1,\n spectrum=True, observations=True)\n```\n\nEn este ejemplo, explore_multiverse se utiliza para generar 10 conjuntos diferentes de espectros y observaciones del sistema systemtrappist1, variando las condiciones de cada conjunto y guardando los resultados en el directorio especificado.\n\n\n## What's new\n\nIf your package will be frequently updated with new features include a\nsection describing the new features added to it:\n\nVersion 0.1.*:\n\n- First version of the package.\n\n------------\n\nThis package has been designed and written by David Duque-Casta\u00f1o and Jorge I. Zuluaga (C) 2023\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Massive planetary spectra generator",
"version": "0.1.5",
"project_urls": {
"Homepage": "https://pypi.org/project/multirex"
},
"split_keywords": [
"exoplanets",
"astrobiology",
"astronomy",
"spectroscopy"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9673131f6a0b215e8fa77e745fc208a42fb6c168877a7340c2f0394022866a28",
"md5": "74bb53b2038bb18e6374d1cef51e1d2b",
"sha256": "8a5f14792da0f0a28328b68b7c8036ce19bbc54a69cd19072dc3505c841e7e2c"
},
"downloads": -1,
"filename": "multirex-0.1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "74bb53b2038bb18e6374d1cef51e1d2b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 23769216,
"upload_time": "2024-04-05T03:37:56",
"upload_time_iso_8601": "2024-04-05T03:37:56.935621Z",
"url": "https://files.pythonhosted.org/packages/96/73/131f6a0b215e8fa77e745fc208a42fb6c168877a7340c2f0394022866a28/multirex-0.1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f0ca671833d12918421d5d6f897c19081c3abf0e5d4a2ff52c201d5702f28c27",
"md5": "08dd1ddb8ba21e155c8ab4045a61480c",
"sha256": "2a8a4191d77b96ec4186233c6c04b3c6e0614b4470e72bb929bcdb2d1085740f"
},
"downloads": -1,
"filename": "multirex-0.1.5.tar.gz",
"has_sig": false,
"md5_digest": "08dd1ddb8ba21e155c8ab4045a61480c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 23203628,
"upload_time": "2024-04-05T03:38:02",
"upload_time_iso_8601": "2024-04-05T03:38:02.649361Z",
"url": "https://files.pythonhosted.org/packages/f0/ca/671833d12918421d5d6f897c19081c3abf0e5d4a2ff52c201d5702f28c27/multirex-0.1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-05 03:38:02",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "multirex"
}