DustPy Documentation

DustPy is a Python package to simulate the evolution of dust in protoplanetary disks.

This documentation is for DustPy v1.0.6.

DustPy simulates the radial evolution of gas and dust in protoplanetary disks, including viscous evolution of the gas, advection and diffusion of the dust, as well as dust growth by solving the Smoluchowski equation.

DustPy has been published in Stammler & Birnstiel (2022).

DustPy can be installed via the Python Package Index

pip install dustpy

DustPy requires a Python3 distribution and a Fortran compiler.

DustPy is based on the Simframe framework for scientific simulation (Stammler & Birnstiel 2022).

Please have a look at the Simframe Documentation for details of its usage.

dustpylib is a collection of auxiliary tools and extensions for DustPy, containing for example interfaces to radiative transfer codes.

For more details, please have a look at the dustpylinbdocumentation.

Contents:

• 1. Basic usage
  • The Simulation Frame
  • Initializing
  • Running a Simulation
  • Plotting
  • Reading data files
  • Reading Dump Files
• 2. Simple Customization
  • Stellar parameters
  • Grid parameters
  • Gas Parameters
  • Dust Parameters
  • Changing the Initial Conditions
  • Changing the Snapshots
  • Changing the Output Directory
• 3. Advanced Customization
  • Customizing the Grids
  • Customizing the Physics of a Field
  • Adding Custom Fields
  • Modifying the Update Order
  • Systoles and Diastoles
  • Customizing the Snapshots
• 4. The Standard Model
  • Dust
  • Gas
  • Grid
  • Star
  • Time
  • Integrator
  • Writer
• 5. Dust Coagulation
  • Sticking
  • Fragmentation & Erosion
  • Probabilities
  • Bouncing
  • Collision Rates
  • Coagulation Sources
• 6. Dust Evolution
  • Coagulation
  • Hydrodynamics
  • External Sources
  • Turning off Dust Evolution
  • Changing the Dust Integrator
• 7. Gas Evolution
  • Hydrodynamics
  • External Sources
  • Turning off Gas Evolution
• Library: dustpylib
• Test: Analytical Coagulation Kernels
  • The Constant Kernel
  • The Linear Kernel
  • The Product Kernel
• Test: Gas Evolution
  • Analytical Solution
  • Setting up DustPy
  • Modifying the Power Law Index
• Example: Ice Lines
• Example: Planetary Gaps
  • Gap Profiles
  • Adding planets
  • Viscosity pertubation
  • Growing planets
• Example: Planetesimal Formation
  • Refining the radial grid
  • Adding gap
  • Adding planetesimals
  • Adding planetesimal formation
• Appendix A: Citation
• Appendix B: List of Publications
• Appendix C: Contributing/Bugs/Features
  • Contributing
  • Bug Reports
  • Feature Requests
• Appendix D: DustPy Discussions
• Appendix E: Changelog
  • v1.0.6
  • v1.0.5
  • v1.0.4
  • v1.0.3
  • v1.0.2
  • v1.0.1
  • v1.0.0
• Module Reference
  • dustpy Package
  • dustpy.constants Package
  • dustpy.plot Package
  • dustpy.std Package
  • dustpy.std.dust Module
  • dustpy.std.gas Module
  • dustpy.std.grid Module
  • dustpy.std.sim Module
  • dustpy.std.star Module
  • dustpy.utils Package

Indices and tables

• Index

• Module Index