Skip to content

Tools for analysis of N-body models with Basis Function Expansions and perturbation theory themes.

License

Notifications You must be signed in to change notification settings

michael-petersen/exptool

Repository files navigation

exptool: galactic dynamics in python using basis function expansions

msp, 2014-present

Version 0.4

exptool is primarily collection of analysis methods used to analyze n-body simulations, primarily those running with EXP, though any n-body code could use the methodology (Generation 0.1).

As of 2018, exptool has expanded to be an all-purpose dynamical framework for studying disc galaxies (Generation 0.2).

As of 2020, exptool includes support for analysing stellar halos (Generation 0.3).

As of 2024, exptool supports analysis of cosmological simulation outputs for bar measurements and a range of basic dynamical models (Generation 0.4).

Installation

exptool is not a registered package, so the best installation is

git clone [email protected]:michael-petersen/exptool.git
cd exptool
pip install . --user
python tests/importtest.py

and then you will be ready to use it! For any updates, you'll need to git pull and rebuild using pip install . --user.

The tests/ directory contains simulation outputs to play with, as well as some usage examples for methods.

Contents

  • analysis
    • analysis tools from publications below
  • basis
    • computational classes for orthogonal expansions
  • io
    • input/output methods
  • models
    • analytic models
  • observables
    • observational comparison methods
  • orbits
    • computational classes for orbit analysis
  • perturbation
    • perturbation theory methods
  • utils
    • helper functions

Publications using exptool

    Generation 3
  1. Weinberg, M.D. & Petersen, M. S. Using multichannel singular spectrum analysis to study galaxy dynamics, 2021, MNRAS, 501, 5408
  2. Petersen, M. S. & Penarrubia, J. Detection of the Milky Way reflex motion due to the Large Magellanic Cloud infall, 2020, Nature Astronomy
  3. Petersen, M. S. & Penarrubia, J. Reflex motion in the Milky Way stellar halo resulting from the Large Magellanic Cloud infall, 2020, MNRAS Letters, 494, 11

  4. Generation 2
  5. Petersen, M. S., Weinberg, M. D., and Katz, N. Using Harmonic Decomposition to Understand Barred Galaxy Evolution. arXiv e-prints.
  6. Petersen, M. S., Weinberg, M. D., and Katz, N. Using Torque to Understand Barred Galaxy Evolution, 2019, MNRAS, 490, 3616
  7. Petersen, M. S., Weinberg, M. D., and Katz, N. Using Commensurabilities and Orbit Structure to Understand Barred Galaxy Evolution. 2021, MNRAS, 500, 868.

  8. Generation 1
  9. Petersen, M. S., Katz, N., and Weinberg, M.D. The Dynamical Response of Dark Matter to Galaxy Evolution Affects Direct-Detection Experiments, 2016, Physical Review D, 94, 123013. Figure 4 was featured in the journal's "Kaleidoscope".
  10. Petersen, M. S., Weinberg, M. D., and Katz, N. Dark matter trapping by stellar bars: the shadow bar 2016, MNRAS, 463, 1952.
  11. Petersen, M. S., Weinberg, M. D., and Katz, N. Creation of Peanut-Shaped Bulges via the Slow Mode of Bar Growth ASPC, 480, 157.