Welcome to PA3Py’s documentation!

PA3Py is a Python post-processing package for computing pebble accretion growth of planetary embryos from TripodPy hydrodynamic disk simulations. It is not a standalone disk evolution code — it reads TripodPy HDF5 output snapshots and computes embryo growth on top of them.

The physics follows Ormel (2017) and Drążkowska et al. (2023), including headwind/shear regime switching, 2D–3D turbulence transition, Safronov ballistic onset, and a dynamic isolation mass cap.

Contents:

• Pebble Accretion 3 (PA3Py)
  • 1. Critical Mass for Pebble Accretion Onset (Onset Mass)
  • 2. Dynamical Accretion Equations
  • 3. Analytical Transition to a 3D Disk
  • 4. Regulatory Isolation Mass
  • 5. Consumption and Drift
  • 6. Planetary Composition (Physical Tracking)
• 1. Getting Started with PA3Py
  • Initializing the Simulation
  • Running Growth
  • Plotting Mass Evolution
  • Water Mass Fraction
• 2. Advanced Chemistry (Dynamic Zones)
  • Custom Composition Function
  • Running Custom Chemistry
• 3. Synthetic Populations and HDF5 I/O
  • Plotting the Hovmöller Diagram
  • Defining the Synthetic Population
  • Saving Results (HDF5)
  • Loading Results
• API Reference
  • Core Simulation Interface
  • Physics Engine
  • Data Handling
  • Composition Models

Installation

Clone the repository and install via pip:

git clone https://github.com/mmmaxii/PA3Py.git
cd PA3Py
pip install .

Requirements

• Python ≥ 3.9

• TripodPy simulation output (HDF5 snapshots)

• numpy, scipy, h5py, matplotlib