Skip to main content

BALRoGO

pipeline status coverage report pypi python license

logo

BALRoGO: Bayesian Astrometric Likelihood Recovery of Galactic Objects.

  • Specially developed to handle data from the Gaia space mission.
  • Extracts galactic objects such as globular clusters and dwarf galaxies from data contaminated by interlopers.
  • Uses a combination of Bayesian and non-Bayesian approaches.
  • Provides:
    • Fits of proper motion space.
    • Fits of surface density.
    • Fits of object center.
    • Confidence regions for the color-magnitude diagram and parallaxes.

If something does not work, please file an issue.

Attribution

Please cite us if you find this code useful in your research. The BibTeX entry for the paper is:

@ARTICLE{Vitral21,
   author = {{Vitral}, Eduardo},
    title = "BALRoGO: Bayesian Astrometric Likelihood Recovery of Galactic Objects - Global properties of over one hundred globular clusters with Gaia EDR3",
  journal = {\mnras},
     year = 2021,
    month = jun,
   volume = {504},
   number = {1},
    pages = {1355-1369},
      doi = {10.1093/mnras/stab947},
   eprint = {2102.04841},
   adsurl = {https://ui.adsabs.harvard.edu/abs/2021MNRAS.504.1355V},
}

Quick overview

BALRoGO has nine modules that perform different tasks:

  • angle.py : This module contains the main functions concerning angular tansformations, sky projections and spherical trigonomtry.
  • gaia.py : This module contains the main functions concerning the handling of the Gaia mission data.
  • hrd.py : This module contains the main functions concerning the color magnitude diagram (CMD). It provides a Kernel Density Estimation (KDE) of the CMD distribution.
  • marginals.py : This module is based on the Python corner package (Copyright 2013-2016 Dan Foreman-Mackey & contributors, The Journal of Open Source Software): https://joss.theoj.org/papers/10.21105/joss.00024 I have done some modifications on it so it allows some new features and so it takes into account some choices as default. I thank Gary Mamon for his good suggestions concerning the plot visualization.
  • parallax.py : This module contains the main functions concerning parallax information. It provides a kernel density estimation of the distance distribution, as well as a fit of the mode of this distribution.
  • pm.py : This module contains the main functions concerning proper motion data. It provides MCMC and maximum likelihood fits of proper motions data, as well as robust initial guesses for those fits.
  • position.py : This module contains the main functions concerning positional information. It provides MCMC and maximum likelihood fits of surface density, as well as robust initial guesses for the (RA,Dec) center of the source.
  • mock.py : This module handles mock data sets. It converts 3D coordinates to sky coordinates and is able to add realistic errors to proper motions. It is also able to generate Milky Way interlopers.
  • dynamics.py : This module handles conversions from celestial coordinates to plane of sky coordinates (vPOSr,vPOSt), as well as allows computation of dispersion profiles in different ways. Also computes the velocity anisotropy from cartesian data.

Installation

BALRoGO is available through pip. The quickiest way to install it is to type the following command in your terminal:

pip install balrogo

If you are using Anaconda, you might want to install it directly in your Anaconda bin path:

cd path/anaconda3/bin/
pip install balrogo

For updated versions of the code, you can do the same as above, but instead of using pip install balrogo, you should type:

pip install --upgrade balrogo

Using BALRoGO on Gaia data

For quick tutorial of BALRoGO applied to Gaia data, please click here.

License

Copyright (c) 2020 Eduardo Vitral & Alexandre Macedo.

BALRoGO is free software made available under the MIT License. The BALRoGO logo is licensed under a Creative Commons Attribution 4.0 International license.

Metadata

Release files for balrogo 1.10.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for balrogo 1.10.0
File Size Uploaded
balrogo-1.10.0.tar.gz 68.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for balrogo 1.10.0
File Interpreter ABI Platform
balrogo-1.10.0-py3-none-any.whl Python 3 none any Details

Total release size: 139.7 kB

Release files / balrogo-1.10.0.tar.gz

Download URL balrogo-1.10.0.tar.gz
Size 68.0 kB
Tags Source
SHA-256 checksum
How to use checksums
a3835d2a024e011f09b8d9284758b7d8bbfb9304b1caf80f945b5d4479b16a6b
BLAKE2b-256 checksum
How to use checksums
5a4fd11ca55a33f2feaa87a90410a80a0fb732310c331cf9d8d80b446de6eb01
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.11.8

Release files / balrogo-1.10.0-py3-none-any.whl

Download URL balrogo-1.10.0-py3-none-any.whl
Size 71.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
06d207ee97b03b808f8aee6fb2f46a0dee4ee37eb55548dd47d89893309dccc1
BLAKE2b-256 checksum
How to use checksums
d5a0792ce404e8ee4bb248bd56861ad961ced5e689f1e2ca720a252a426db086
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.11.8

Release history Release notifications | RSS feed

This release

1.10.0 This release

2 release files

1.9.8

2 release files

1.9.7

2 release files

1.9.6

2 release files

1.9.5

2 release files

1.9.4

2 release files

1.9.3

2 release files

1.9.2

2 release files

1.9.1

2 release files

1.9.0

2 release files

1.8.7

2 release files

1.8.6

2 release files

1.8.5

2 release files

1.8.4

2 release files

1.8.3

2 release files

1.8.2

2 release files

1.8.1

2 release files

1.8.0

2 release files

1.7.10

2 release files

1.7.9

2 release files

1.7.8

2 release files

1.7.7

2 release files

1.7.6

2 release files

1.7.5

2 release files

1.7.4

2 release files

1.7.3

2 release files

1.7.2

2 release files

1.7.1

2 release files

1.7.0

2 release files

1.6.9

2 release files

1.6.8

2 release files

1.6.7

2 release files

1.6.6

2 release files

1.6.5

2 release files

1.6.4

2 release files

1.6.2

2 release files

1.6.1

2 release files

1.6.0

2 release files

1.5.5

2 release files

1.5.4

2 release files

1.5.3

2 release files

1.5.2

2 release files

1.5.1

2 release files

1.5.0

2 release files

1.4.9

2 release files

1.4.8

2 release files

1.4.7

2 release files

1.4.6

2 release files

1.4.5

2 release files

1.4.4

2 release files

1.4.3

2 release files

1.4.2

2 release files

1.4.1

2 release files

1.4.0

2 release files

1.3.11

2 release files

1.3.10

2 release files

1.3.9

2 release files

1.3.8

2 release files

1.3.7

2 release files

1.3.6

2 release files

1.3.5

2 release files

1.3.4

2 release files

1.3.3

2 release files

1.3.2

2 release files

1.3.1

2 release files

1.3.0

2 release files

1.2.2

2 release files

1.2.1

2 release files

1.2.0

2 release files

1.1.0

2 release files

1.0.0

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.3

2 release files

0.5.2

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.0

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page