BASTA 1.5.0__tar.gz

basta-1.5.0/.dir-locals.el

@@ -0,0 +1 @@
+((python-mode . ((flycheck-flake8rc . "setup.cfg") (flycheck-pylintrc . "setup.cfg"))))

basta-1.5.0/.gitignore

@@ -0,0 +1,126 @@
+# Output-folders
+output*/
+examples/output*/
+
+# Input/output files
+*.log
+*.pdf
+*.p
+*.dat
+*.res
+*.out
+*.bak
+*.hdf5
+*.htm
+
+# Re-include pdf's for the documentation
+!/examples/reference/*.pdf
+!/examples/reference/*/*.pdf
+
+# Documentation
+.idea
+docs/old
+docs/.idea
+examples/make_input.py
+
+# Demo scripts
+examples/*.xml
+examples/*/*.xml
+examples/grids/
+reference_*/
+reference_note.txt
+
+# Editor
+*.swp
+.vscode/
+
+# Folder for downloading/storing the dustmaps (and grids)
+dustmaps/
+_dustpath.py
+grids/
+_gridpath.py
+
+# Virtual environment
+/venv*/
+/bastaenv/
+
+###########
+### Generic
+###########
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*,cover
+.hypothesis/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Ipython Notebook
+.ipynb_checkpoints
+
+# Checkers
+.mypy_cache
+
+# Pyenv
+.python-version
+
+# Fortran/F2PY compilation
+fort.*
+*.dSYM
+*.md5
+
+# Misc
+.DS_Store

basta-1.5.0/.pre-commit-config.yaml

@@ -0,0 +1,16 @@
+repos:
+- repo: https://github.com/pre-commit/pre-commit-hooks
+  rev: v5.0.0
+  hooks:
+  - id: trailing-whitespace
+  - id: end-of-file-fixer
+  - id: check-yaml
+  - id: check-added-large-files
+    args: [--maxkb=2000]
+  - id: check-ast
+  - id: check-merge-conflict
+- repo: https://github.com/psf/black
+  rev: 24.10.0
+  hooks:
+  - id: black
+    exclude: venv*/|dustmaps/|grids/

basta-1.5.0/.readthedocs.yaml

@@ -0,0 +1,22 @@
+# .readthedocs.yaml
+# Read the Docs configuration file (updated based on September 2023 migration)
+# https://blog.readthedocs.com/migrate-configuration-v2/
+
+# Required
+version: 2
+
+# Set the version of Python and other tools you might need
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.12"
+
+# Build documentation in the docs/ directory with Sphinx
+sphinx:
+  configuration: docs/conf.py
+
+# Specified dependencies
+# https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
+python:
+  install:
+  - requirements: docs/requirements.txt

basta-1.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 The BASTA development team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

basta-1.5.0/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.3
+Name: BASTA
+Version: 1.5.0
+Summary: The BAyesian STellar Algorithm
+Project-URL: Homepage, https://github.com/BASTAcode/BASTA
+Project-URL: Documentation, https://basta.readthedocs.io
+Project-URL: Issues, https://github.com/BASTAcode/BASTA/issues
+Project-URL: Repository, https://github.com/BASTAcode/BASTA.git
+Author-email: The BASTA Team <jakob@phys.au.dk>
+Maintainer-email: Jakob Lysgaard Rørsted <jakob@phys.au.dk>
+License: MIT License
+        
+        Copyright (c) 2024 The BASTA development team
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Requires-Python: >=3.10
+Requires-Dist: astropy>=6.1.4
+Requires-Dist: black>=24.10.0
+Requires-Dist: bottleneck>=1.4.2
+Requires-Dist: dustmaps>=1.0.13
+Requires-Dist: h5py>=3.12.1
+Requires-Dist: healpy>=1.18.0
+Requires-Dist: matplotlib>=3.9.2
+Requires-Dist: numpy>=2.1.3
+Requires-Dist: pre-commit>=4.0.1
+Requires-Dist: scikit-learn>=1.5.2
+Requires-Dist: scipy>=1.14.1
+Requires-Dist: tqdm>=4.67.0
+Description-Content-Type: text/markdown
+
+# BASTA: The BAyesian STellar Algorithm
+
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+[![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Documentation Status](https://readthedocs.org/projects/basta/badge/?version=latest)](https://basta.readthedocs.io/en/latest/?badge=latest)
+[![arXiv](https://img.shields.io/badge/arXiv-2109.14622-b31b1b.svg)](https://arxiv.org/abs/2109.14622)
+[![ADS](https://img.shields.io/badge/ads-2022MNRAS.509.4344A-blue.svg)](https://ui.adsabs.harvard.edu/abs/2022MNRAS.509.4344A/abstract)
+[![DOI](https://img.shields.io/badge/doi-10.1093/mnras/stab2911-orange.svg)](https://doi.org/10.1093/mnras/stab2911)
+
+Current stable version: v1.5.0
+
+**Important note:** BASTA is currently developed for Python 3.12, but Python >= 3.10 should suffice.
+
+
+## Before you begin
+
+*Please follow the repository on GitHub to get notifications on new releases: Click "Watch" then "Custom" and tick "Releases.*
+
+Please have a look at [our documentation](https://basta.readthedocs.io/en/latest/index.html#).
+
+There we have written a guide [guide to installing BASTA](https://basta.readthedocs.io/en/latest/install.html).
+
+On there, you will also find an [introduction to running BASTA](https://basta.readthedocs.io/en/latest/running.html).
+
+If you are curious on what BASTA can do, we have created several [fitting examples](https://basta.readthedocs.io/en/latest/examples.html) and the exact code to run them available.
+
+If you have any questions, or encounter any issues, feel free to write to us through the [discussions page](https://github.com/orgs/BASTAcode/discussions).
+
+
+## Quick start guide
+
+BASTA can be obtained from GitHub or from the Python Package Index (PyPI); the full details are given in the documentation.
+
+*We strongly recommend to create a fresh virtual environment to install BASTA in!*
+
+With the virtual environment activated:
+
+```
+pip install basta
+```
+
+To make the code ready to run you need to download some additional assets: a grid of stellar models and the dustmaps. To complete the setup of the code and download the grid used in most of our examples run the following (feel free to change the paths as you like):
+
+```
+mkdir -p ~/BASTA/grids
+mkdir -p ~/BASTA/dust
+BASTAdownload --gridpath ~/BASTA/grids --dustpath ~/BASTA/dust 16CygA
+```
+
+Finally, to obtain the full suite of examples run:
+
+```
+cd ~/BASTA
+BASTAexamples full
+```
+
+Congratulations! You now have a fully functional installation of BASTA! We strongly recommend looking at the documentation for information on how to use the code.
+
+
+
+
+
+## References and acknowledgments
+
+There are two papers containing the rationale, main features, and capabilities of the code:
+
+* [The BASTA paper I](https://ui.adsabs.harvard.edu/abs/2015MNRAS.452.2127S/abstract).
+* [The BASTA paper II](https://ui.adsabs.harvard.edu/abs/2022MNRAS.509.4344A/abstract).
+
+Please cite these references if you use BASTA in your work, and include the link to the code's repository `https://github.com/BASTAcode/BASTA`.
+
+Due to its versatility, BASTA is used in a large variety of studies requiring robust determination of fundamental stellar properties. We have compiled a (non-exhaustive) [list of papers using BASTA results](https://ui.adsabs.harvard.edu/public-libraries/x2tCt52HR_yqG-oaUabo_A) that showcases these applications. If your paper using BASTA results is missing from the list please contact us.
+
+
+## Authors
+
+The current core developing team members are:
+
+* Jakob Lysgaard Rørsted (maintainer)
+* Mark Lykke Winther (co-maintainer)
+* Amalie Stokholm (co-maintainer)
+* Kuldeep Verma
+
+
+The original author of the code is:
+
+* Víctor Aguirre Børsen-Koch
+
+
+Throughout the years, many people have contributed to the addition and development of various parts and modules of BASTA. We welcome further contributions from the community as well as issues reporting. Please look at the [contribution section](https://basta.readthedocs.io/en/latest/contributing.html) in the documentation for further details.
+
+
+## Listings
+
+In addition to the shields/icons in the top, BASTA can be found in the following software listings/catalogues:
+
+* Astrophysics Source Code Library / [ASCL](https://ascl.net/2110.010)
+* Exoplanet Modeling and Analysis Center / [EMAC](https://emac.gsfc.nasa.gov#bbcded4b-27d8-49f5-be4d-76e1fec748eb)
+* The Python Package Index / [PyPI](https://pypi.org/project/basta/)

basta-1.5.0/README.md

@@ -0,0 +1,99 @@
+# BASTA: The BAyesian STellar Algorithm
+
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+[![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Documentation Status](https://readthedocs.org/projects/basta/badge/?version=latest)](https://basta.readthedocs.io/en/latest/?badge=latest)
+[![arXiv](https://img.shields.io/badge/arXiv-2109.14622-b31b1b.svg)](https://arxiv.org/abs/2109.14622)
+[![ADS](https://img.shields.io/badge/ads-2022MNRAS.509.4344A-blue.svg)](https://ui.adsabs.harvard.edu/abs/2022MNRAS.509.4344A/abstract)
+[![DOI](https://img.shields.io/badge/doi-10.1093/mnras/stab2911-orange.svg)](https://doi.org/10.1093/mnras/stab2911)
+
+Current stable version: v1.5.0
+
+**Important note:** BASTA is currently developed for Python 3.12, but Python >= 3.10 should suffice.
+
+
+## Before you begin
+
+*Please follow the repository on GitHub to get notifications on new releases: Click "Watch" then "Custom" and tick "Releases.*
+
+Please have a look at [our documentation](https://basta.readthedocs.io/en/latest/index.html#).
+
+There we have written a guide [guide to installing BASTA](https://basta.readthedocs.io/en/latest/install.html).
+
+On there, you will also find an [introduction to running BASTA](https://basta.readthedocs.io/en/latest/running.html).
+
+If you are curious on what BASTA can do, we have created several [fitting examples](https://basta.readthedocs.io/en/latest/examples.html) and the exact code to run them available.
+
+If you have any questions, or encounter any issues, feel free to write to us through the [discussions page](https://github.com/orgs/BASTAcode/discussions).
+
+
+## Quick start guide
+
+BASTA can be obtained from GitHub or from the Python Package Index (PyPI); the full details are given in the documentation.
+
+*We strongly recommend to create a fresh virtual environment to install BASTA in!*
+
+With the virtual environment activated:
+
+```
+pip install basta
+```
+
+To make the code ready to run you need to download some additional assets: a grid of stellar models and the dustmaps. To complete the setup of the code and download the grid used in most of our examples run the following (feel free to change the paths as you like):
+
+```
+mkdir -p ~/BASTA/grids
+mkdir -p ~/BASTA/dust
+BASTAdownload --gridpath ~/BASTA/grids --dustpath ~/BASTA/dust 16CygA
+```
+
+Finally, to obtain the full suite of examples run:
+
+```
+cd ~/BASTA
+BASTAexamples full
+```
+
+Congratulations! You now have a fully functional installation of BASTA! We strongly recommend looking at the documentation for information on how to use the code.
+
+
+
+
+
+## References and acknowledgments
+
+There are two papers containing the rationale, main features, and capabilities of the code:
+
+* [The BASTA paper I](https://ui.adsabs.harvard.edu/abs/2015MNRAS.452.2127S/abstract).
+* [The BASTA paper II](https://ui.adsabs.harvard.edu/abs/2022MNRAS.509.4344A/abstract).
+
+Please cite these references if you use BASTA in your work, and include the link to the code's repository `https://github.com/BASTAcode/BASTA`.
+
+Due to its versatility, BASTA is used in a large variety of studies requiring robust determination of fundamental stellar properties. We have compiled a (non-exhaustive) [list of papers using BASTA results](https://ui.adsabs.harvard.edu/public-libraries/x2tCt52HR_yqG-oaUabo_A) that showcases these applications. If your paper using BASTA results is missing from the list please contact us.
+
+
+## Authors
+
+The current core developing team members are:
+
+* Jakob Lysgaard Rørsted (maintainer)
+* Mark Lykke Winther (co-maintainer)
+* Amalie Stokholm (co-maintainer)
+* Kuldeep Verma
+
+
+The original author of the code is:
+
+* Víctor Aguirre Børsen-Koch
+
+
+Throughout the years, many people have contributed to the addition and development of various parts and modules of BASTA. We welcome further contributions from the community as well as issues reporting. Please look at the [contribution section](https://basta.readthedocs.io/en/latest/contributing.html) in the documentation for further details.
+
+
+## Listings
+
+In addition to the shields/icons in the top, BASTA can be found in the following software listings/catalogues:
+
+* Astrophysics Source Code Library / [ASCL](https://ascl.net/2110.010)
+* Exoplanet Modeling and Analysis Center / [EMAC](https://emac.gsfc.nasa.gov#bbcded4b-27d8-49f5-be4d-76e1fec748eb)
+* The Python Package Index / [PyPI](https://pypi.org/project/basta/)

basta-1.5.0/docs/Makefile

@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+SPHINXPROJ    = BASTA
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

basta-1.5.0/docs/conf.py

@@ -0,0 +1,124 @@
+# Configuration file for the Sphinx documentation builder.
+#
+# This file only contains a selection of the most common options. For a full
+# list see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Path setup --------------------------------------------------------------
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#
+import os
+import sys
+
+# Make the modules importable
+sys.path.insert(0, os.path.abspath(".."))
+sys.path.insert(0, os.path.abspath("../src/basta"))
+sys.path.insert(0, os.path.abspath("../examples"))
+
+# -- Project information -----------------------------------------------------
+
+# General information about the project.
+project = "BASTA"
+copyright = "2024, The BASTA Team"
+author = "The BASTA Team"
+
+# The short X.Y version.
+version = "1.5.0"
+
+# The full version, including alpha/beta/rc tags.
+release = "1.5.0"
+
+
+# -- General configuration ------------------------------------------------
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.todo",
+    "sphinx.ext.mathjax",
+    "sphinx.ext.viewcode",
+    "sphinx.ext.napoleon",
+]
+
+# Napoleon (docstring reading) settings
+napoleon_google_docstring = False
+napoleon_use_param = False
+napoleon_use_rtype = False
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+#
+source_suffix = ".rst"
+
+# The master toctree document.
+master_doc = "index"
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = "en"
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This patterns also effect to html_static_path and html_extra_path
+exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = False
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {"https://docs.python.org/3/": None}
+
+# This value contains a list of modules to be mocked up. This is useful when some
+# external dependencies are not met at build time and break the building process.
+# You may only specify the root package of the dependencies themselves and omit
+# the sub-modules:
+autodoc_mock_imports = [
+    "astropy",
+    "bottleneck",
+    "dustmaps",
+    "h5py",
+    "healpy",
+    "matplotlib",
+    "scikit-learn",
+    "sklearn",
+    "scipy",
+    "tqdm",
+]
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "sphinx_rtd_theme"
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ["_static"]
+
+# Logo
+html_logo = "basta_crop_low-res.png"
+html_theme_options = {
+    "logo_only": True,
+}
+
+
+# -- Options for HTMLHelp output ------------------------------------------
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "BASTAdoc"