Configuration Reference: Postprocessor YAML

Table of Contents

• 1. File Structure
• 3. source_data
• 4. Processing Pipelines
• 5. Statistics Pipeline

For the full commented template, see:

post.yml defines postprocessing input range, processing pipelines, statistics tasks, and VTK output selection.

1. File Structure

run_control:
  start_step: 100
  end_step: 1000
  step_interval: 100
 
source_data:
  directory: "<solver_output_dir>"
 
global_operations:
  dimensionalize: true
 
eulerian_pipeline:
  - task: nodal_average
    input_field: Ucat
    output_field: Ucat_nodal
  - task: q_criterion
 
lagrangian_pipeline:
  - task: specific_ke
    input_field: velocity
    output_field: SpecificKE
 
statistics_pipeline:
  output_prefix: "Stats"
  tasks:
    - task: msd
 
io:
  output_directory: "viz"
  output_filename_prefix: "Field"
  particle_filename_prefix: "Particle"
  output_particles: true
  eulerian_fields: [Ucat_nodal, Qcrit]
  particle_fields: [velocity, SpecificKE]

2. run_control

Mappings in generated post.run:

• start_step -> startTime
• end_step -> endTime
• step_interval -> timeStep

3. source_data

• source_data.directory -> source_directory
• <solver_output_dir> is a supported placeholder resolved by pic.flow.

4. Processing Pipelines

Eulerian tasks (eulerian_pipeline):

• q_criterion -> ComputeQCriterion
• nodal_average -> CellToNodeAverage:<in>><out>
• normalize_field -> NormalizeRelativeField:<field>

Global operation:

• global_operations.dimensionalize: true prepends DimensionalizeAllLoadedFields

Lagrangian tasks (lagrangian_pipeline):

• specific_ke -> ComputeSpecificKE:<in>><out>

5. Statistics Pipeline

statistics_pipeline supports either:

• list form, or
• mapping with tasks and optional output_prefix

Currently supported task alias set maps to C kernel ComputeMSD.

Mappings:

• tasks -> statistics_pipeline
• output_prefix -> statistics_output_prefix

1. io

Mappings:

• output_directory + output_filename_prefix -> output_prefix
• output_directory + particle_filename_prefix -> particle_output_prefix
• output_particles -> output_particles
• particle_subsampling_frequency -> particle_output_freq
• eulerian_fields -> output_fields_instantaneous
• eulerian_fields_averaged -> output_fields_averaged (reserved)
• particle_fields -> particle_fields_instantaneous
• input_extensions.eulerian -> eulerianExt
• input_extensions.particle -> particleExt

Default post input extension remains dat unless overridden.

9. Next Steps

Proceed to User How-To Guides for goal-oriented recipes.

For mapping and extension details:

• Developer Ingestion Map
• Configuration Extension Playbook