imripy

A python code able to simulate Intermediate Mass Ratio Inspirals (IMRI)

https://github.com/dmgw-goethe/imripy

Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 3 DOI reference(s) in README
  • Academic publication links
    Links to: arxiv.org, iop.org
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (9.9%) to scientific vocabulary
Last synced: 7 months ago · JSON representation ·

Repository

A python code able to simulate Intermediate Mass Ratio Inspirals (IMRI)

Basic Info
  • Host: GitHub
  • Owner: DMGW-Goethe
  • License: mit
  • Language: Jupyter Notebook
  • Default Branch: main
  • Size: 13.9 MB
Statistics
  • Stars: 12
  • Watchers: 2
  • Forks: 6
  • Open Issues: 0
  • Releases: 0
Created over 4 years ago · Last pushed about 2 years ago
Metadata Files
Readme License Citation

README.md

IMRIpy

This code allows the simulation of an Intermediate Mass Ratio Inspiral (IMRI), where a small compact object -- the secondary -- is around an orbit of a larger body -- the primary, usually a massive black hole (MBH). \ The system loses energy and angular momentum due to dissipative forces and slowly inspirals. The dissipative forces include gravitation wave (GW) emission, dynamical friction with dark matter (DM), interaction with an accretion disk, or stellar diffusion in stellar cusps.

The main purpose of the code is to solve the differential equations that arise in the modeling of IMRIs. The code can track the semimajor-axis, eccentricity, periapse angle, and inclination angle of the Kepler orbit. This orbit changes over time due to different dissipative forces. The code is very modular in design such that different dissipative forces can be added easily and their effects studied in detail. Additionally, the code can explore the phase space flows of the forces, compute the GW signal and compare it to LISA sensitivity.

The code also includes a stochastic description of some of the interactions with the help of stochastic differential equations (SDEs). This can be used to calculate rates and population behavior.

Models

For most of the functionality look at the dissertation here.

This code has been used in our publications 2112.09586 and 2211.05145. See this and this file respectively for plot generation.

The code includes inspiral models from \ 9402014 - gravitational wave emission \ 1408.3534, 2204.12508, 2305.17281, 1711.09706 - DM halos + dynamical friction + accretion \ 1908.10241, 2107.00741, 1807.07163 - Keplerian orbits and waveforms \ 2002.12811,2108.04154 - Halo Feedback \ 2207.10086, 10.1086/324713, 10.1093/mnras/stac1294, 2205.10382 - Accretion disk profile + interactions \ 1508.01390 - Stellar Diffusion

Usage

See examples and dissertation folder.

Install

Clone the repository and run \ pip install -e . \ (the -e option allows you to continuously edit the files without recompiling, don't use if you don't need to edit the files)

If you would like to use the Stochastic module, download the torchsde fork and install it.

Citation

If you use this in your publications, please cite the two papers 2112.09586, and 2211.05145, and the ASCL entry.

License

See LICENSE File

Owner

  • Name: DMGW-Goethe
  • Login: DMGW-Goethe
  • Kind: organization

DMGW working group @ Goethe University Frankfurt

Citation (CITATION.cff)

# This CITATION.cff file was generated with cffinit.
# Visit https://bit.ly/cffinit to generate yours today!

cff-version: 1.2.0
title: imripy
message: >-
  If you use this software, please cite the relevant papers
  from the metadata.
type: software
authors:
  - given-names: Niklas
    family-names: Becker
    email: nbecker@itp.uni-frankfurt.de
    affiliation: Goethe University Frankfurt
    orcid: 'https://orcid.org/0000-0002-8077-430X'
identifiers:
  - type: url
    value: 'https://ascl.net/2307.018'
    description: >-
      [ascl:2307.018] IMRIpy: Intermediate Mass Ratio
      Inspirals simulator 
  - type: doi
    value: 10.1103/PhysRevD.105.063029
    description: >-
      Circularization versus eccentrification in
      intermediate mass ratio inspirals inside dark matter
      spikes
  - type: doi
    value: 10.1103/PhysRevD.107.083003
    description: >-
      Comparing accretion disks and dark matter spikes in
      intermediate mass ratio inspirals
repository-code: 'https://github.com/DMGW-Goethe/imripy'

GitHub Events

Total
Last Year