Concepts

This section explains the main building blocks of a pyRadPlan treatment planning workflow. Each concept corresponds to one or more Python classes and to one step in the workflow shown in Quickstart: The first minimal treatment plan.

Concepts:

• The Plan Object
  • Class hierarchy
  • Creating a plan
  • Key fields
  • Algorithm configuration dictionaries
  • Pydantic validation and serialization
  • matRad interoperability
• CT and Structure Set
  • Loading patient data
  • The CT object
  • The StructureSet object
  • Volumes of Interest (VOI)
  • Attaching optimization objectives
  • matRad interoperability
• Steering: Beam Geometry
  • Generating the steering information
  • Object hierarchy
  • Coordinate systems
  • matRad interoperability
• Dose Calculation
  • The Dij object
  • Dose engines
  • Backend-agnostic computation
  • Multi-scenario support
• Optimization
  • Running optimization
  • Planning problems
  • Solvers
  • Objectives
  • Compute backend
• Quantity System
  • Motivation
  • Available quantities
  • Selecting a quantity for optimization
  • Resolution modes
  • The QuantityResolver
  • Gradients and the Array API
  • Adding custom quantities
• Visualization
  • plot_slice
  • plot_multiple_slices
  • Tips
• AI Agents
  • Overview
  • Model selection
  • Generating beam angles
  • Generating optimization objectives
  • End-to-end example
  • Settings reference
  • API reference

Workflow at a glance

load_patient()          →  CT  +  StructureSet  (patient_data)
IonPlan / PhotonPlan    →  Plan                  (plan)
generate_stf()          →  SteeringInformation   (steering)
calc_dose_influence()   →  Dij                   (dose_calculation)
fluence_optimization()  →  fluence array         (optimization)
dij.compute_result_*()  →  dose result dict      (quantities)
plot_slice()            →  figure                (visualization)

# optional AI-assisted steps
ai_agents.generate_beam_angles()    →  Plan with gantry angles  (ai_agents)
ai_agents.generate_voi_objectives() →  StructureSet with objectives