1
1
# brutus
2
2
#### _ ** Et tu, Brute?** _
3
3
4
- ` brutus ` is a Pure Python package that uses "brute force" Bayesian inference
5
- to derive distances, reddenings, and stellar properties from photometry using
6
- a grid of stellar models.
4
+ ` brutus ` is a Pure Python package whose core modules involve using
5
+ "brute force" Bayesian inference to derive distances, reddenings, and
6
+ stellar properties from photometry using a grid of stellar models.
7
+
8
+ The package is designed to be highly modular, with current modules including
9
+ utilities for modeling individual stars, co-eval stellar associations, and
10
+ stellar-based 3-D dust mapping.
7
11
8
12
### Documentation
9
- ** Currently nonexistent.** Please see the demos for usage examples.
13
+ ** Currently nonexistent.**
10
14
11
15
### Data
12
- While ` brutus ` can be run over an arbitrary set of stellar models,
13
- it is configured for two by default: [ MIST] ( http://waps.cfa.harvard.edu/MIST/ )
16
+
17
+ Various files needed to run different ` brutus ` modules can be downloaded
18
+ [ here] ( https://www.dropbox.com/sh/ozq9tk8iyy8fhte/AAC_G0wA9eQ8shHbZzAKwLe-a?dl=0 ) .
19
+ Various components of these are described below.
20
+
21
+ #### Stellar Models
22
+ Note that while ` brutus ` can (in theory) be run over an arbitrary set of
23
+ stellar models, it is configured for two by default:
24
+ [ MIST] ( http://waps.cfa.harvard.edu/MIST/ )
14
25
and [ Bayestar] ( https://arxiv.org/pdf/1401.1508.pdf ) .
15
26
16
- The current MIST grid (v7) can be found
17
- [ here] ( https://www.dropbox.com/s/g27bn8fmeiaqdxn/grid_mist_v7.h5?dl=0 ) .
18
- The current Bayestar grid (v2) can be found
19
- [ here] ( https://www.dropbox.com/s/mxi8qvlupnxbni7/grid_bayestar_v2.h5?dl=0 ) .
20
-
21
- By default, ` brutus ` also utilizes a 3-D dust prior based on the "Bayestar17"
22
- dust map from [ Green et al. (2018)] ( https://arxiv.org/abs/1801.03555 ) . The
23
- relevant data file can be found
24
- [ here] ( https://www.dropbox.com/s/kkdcnvvuf2t3jt0/bayestar2017_v1.h5?dl=0 ) .
25
-
26
- Zero-point offsets in several provided bands that were derived using Gaia
27
- can be downloaded
28
- [ here] ( https://www.dropbox.com/s/ck43do4chssbyd0/offsets_bs_v2.txt?dl=0 )
29
- for Bayestar and
30
- [ here] ( https://www.dropbox.com/s/j40pqz1g0x0d5kp/offsets_mist_v7.txt?dl=0 )
31
- for MIST.
32
- Make sure you you use the zero-points derived for the grid with
33
- the same version number.
34
-
35
- ### Generating SEDs
36
- ` brutus ` contains built-in SED generation utilities that run over the MIST
37
- stellar models and utilize the SED prediction engine taken from
27
+ #### Zero-points
28
+ Zero-point offsets in several bands have been derived using Gaia data
29
+ and can be included during runtime.
30
+
31
+ #### Dust Map
32
+ ` brutus ` is able to incorporate a 3-D dust prior. The current prior is
33
+ based on the "Bayestar17" dust map from
34
+ [ Green et al. (2018)] ( https://arxiv.org/abs/1801.03555 ) .
35
+
36
+ #### Generating SEDs
37
+ ` brutus ` contains built-in SED generation utilities based on the MIST
38
+ stellar models, modeled off of
38
39
[ ` minesweeper ` ] ( https://github.com/pacargile/MINESweeper ) .
39
- ** ` brutus ` can be installed and run without setting up this capability ** using
40
- the pre-computed grids defined above. This functionality is provided so that
41
- users can generate their own grid of MIST models if desired. Please contact
42
- Phil Cargile ( pcargile@cfa.harvard.edu ) and Josh Speagle
43
- ( jspeagle@cfa.harvard.edu ) for the relevant data files .
40
+ These are optimized for either generating photometry from stellar mass
41
+ tracks or for a single-age stellar isochrone, and are based on
42
+ artificial neural networks trained on bolometric correction tables.
43
+ An empirical correction table to the models derived using several clusters is
44
+ also provided, which improves the models down to ~ 0.5 solar masses .
44
45
45
- An empirical correction table that supplements the data files can be found
46
- [ here ] ( https://www.dropbox.com/s/ufga5zadf1i7d27/corr_mist_v1.txt?dl=0 ) .
46
+ Please contact Phil Cargile ( pcargile@cfa.harvard.edu ) and Josh Speagle
47
+ ( jspeagle@cfa.harvard.edu ) for more information on the provided data files .
47
48
48
49
### Installation
49
50
` brutus ` can be installed by running
@@ -54,5 +55,4 @@ from inside the repository.
54
55
55
56
### Demos
56
57
Several Jupyter notebooks currently outline very basic usage of the code.
57
- Please contact Josh Speagle (jspeagle@cfa.harvard.edu )
58
- if you have any questions.
58
+ Please contact Josh Speagle (jspeagle@cfa.harvard.edu ) with any questions.
0 commit comments