GENGA documentation

Author: Simon L. Grimm

Department of Astrophysics

University of Zürich, Switzerland

GENGA is available at https://bitbucket.org/sigrimm/genga

License

GENGA is free to use, but when results from GENGA are published, then the following papers have to be referenced [GrimmStadel14], [GrimmStadelBrasser+22].

Setup

Setup:

• GENGA Tutorial
• Setup
  • Requirements
  • Install CUDA
  • Install ROCM and HIP for AMD GPUs
  • Determine the NVIDIA compute capability
  • Compile GENGA
• Running GENGA
  • Starting GENGA
  • Restarting GENGA to continue simulations
  • Interrupting a simulation
  • Using test particles
  • Multi simulation mode
  • Generate Keplerian-elements output files
  • Convert output files to barycentric coordinates
  • Convert_P0T1_to_P1T0
  • Convert_P1T0_to_P0T1
  • Cleaning the time files
  • Cleaning the Energy files
  • Irregular output times
  • Use self tuning kernel parameters
  • GengaGL: Real time visualization with openGL
• The initial conditions
  • The initial conditions format
  • Examples
• Units
  • Time
  • Masses
  • Distances, Radii
  • Velocities
  • Spin
  • Energy
  • Angular momentum
  • Time lag
  • Time of first transit
  • Physical constants
• Parameters in the param.dat file
  • Main parameters
  • Stellar parameters
  • Integrator options
  • Memory options
  • Options for the a-e and a-i grid
  • Options for the gas disk
  • Non-Newtonian forces
  • Statistical small body collisions
  • Create particles during integration
  • Options for encounters
  • Options for collisions
  • Other
  • Options for TTVs
• Console Arguments
• Parameters in the define.h File
  • Use old Shuffle
  • Ignore Lock File
  • Memory options
  • Other
  • Physical constants
  • Parameters for the gas disk

Integrator details

Integrator Details:

• Integrator
  • The n1 and n2 values
  • The order of the symplectic integrator
  • Finding close encounter candidates
  • Finding close encounter candidates between test particles
  • Close Encounters Pairs
  • Higher level changeover functions

Output Files

Output Files:

• Output Files
  • The Lock File: lock.dat
  • The Master File: master.out
  • The information file: info<name>.dat
  • The tuningParameters.dat file
  • The Coordinate Output Files: Out<name>.dat
  • The Irregular Coordinate Output Files: OutIrr<name><time>.dat
  • Keplerian-Elemets Output Files: aei<name>.dat
  • Barycentric output Files: OutBary<name>.dat
  • The Energy Output File: Energy<name>.dat
  • The Irregular Energy Output File: EnergyIrr<name>.dat
  • The Execution Time File: time<name>.dat
  • The Collisions File: Collisions<name>.dat
  • The Tshift Collisions File: CollisionsTshift<name>.dat
  • The Stop-at-collision-file: OutCollision.dat
  • The encounter-file: Encounters<name>.dat
  • The ejection file: Ejections<name>.dat
  • The stellar evolution file: Star<name>.dat
  • The Irregular stellar evolution file: StarIrr<name>.dat
  • The Fragments File: Fragments<name>.dat
  • The a-e and a-i grid files: aeCount<grid name><time step>.dat
  • The Poincare surface of section file: Poincare<name><timeInterval>.dat

Options

Options:

• Collisions
  • Collision details
  • Collision precision
  • Backtrace Collisions (TShift)
  • Stop at Collision
• Encounters
  • Report Encounters
  • Report Encounters Cloud Size
  • Stop at Encounter
• Ejections
• aeLimits
• The a-e and a-i grid
• Set-elements function
  • Data table format
• Use single precision in kick forces
• Exact reproducible results
• Poincare surface of section

Forces

Forces:

• Gas disk
  • Gas disk structure
  • Gas drag force
  • Gas disk file
• General Relativity Corrections
  • Hamiltonian splitting (UseGR = 1)
  • Implicit Midpoint (UseGR = 2)
  • Direct Force (UseGR = 3)
  • Test and comparison
• Tidal Forces
  • Tidal spin evolution
  • Test and comparison
• Rotational Deformation
  • Rotational deformation spin evolution
• J2: additional gravitation multipole expansion
• Yarkovsky effect
  • Set the call interval
  • Test of the Yarkovsky effet
• Poynting-Robertson effect
  • Solar Wind
  • Scheme 1: Velocity kick
  • Scheme 2: orbital averaged drift rates
  • Set the call interval
  • Test of the Poynting-Robertson effect

Small body collision model

Small Body Collision Model:

• Model for small bodies collisions
  • Collisional break-up
  • Collisional reset of rotation rate and obliquity
  • Set the call interval

Create particle model

Create particles model:

• Particles Creation Model
  • Particles Creation Mode 1
  • Particles Creation Mode 2

Bibliography

Bibliography:

• Bibliography

Indices and tables

• Index

• Module Index

• Search Page