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.1

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.1
File Size Uploaded
balrogo-1.10.1.tar.gz 68.0 kB Details

Built distribution (wheel)

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

Total release size: 139.7 kB

Release files / balrogo-1.10.1.tar.gz

Download URL balrogo-1.10.1.tar.gz
Size 68.0 kB
Tags Source
SHA-256 checksum
How to use checksums
9bcbeb2cacc2d866233093b56f55fb3d7a988a60d80ce32e6924a51a3198f4b1
BLAKE2b-256 checksum
How to use checksums
ee2571d452b11e6602f4a55cf944205ac73bfb2d3adaa6c54f4a4f1a94a45e09
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.1-py3-none-any.whl

Download URL balrogo-1.10.1-py3-none-any.whl
Size 71.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f3a4f86de31b19f715db111ab4547e61a284ad87e4cb4f0735c77808bfa594e0
BLAKE2b-256 checksum
How to use checksums
8a96826ecd1a0317de9d5380e88a4dcb18ec7da3e10040c73e75eb17537ef619
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.1 This release

2 release files

1.10.0

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