Skip to content

Overview of Pradformat

Envisioned Workflows

Each file format in pradformat is designed to represent 'checkpoint' data at a specific step of the proton radiography workflow. This could allow for the easy gluing together of various existing and future codes.

Here's a diagram of how the pieces might all fit together in a modular workflow that incorporates these formats. In the diagram, the file formats of pradformat (indicated in deep yellow) enable gateways between modular computer codes and data sources provided by the community.

Proton Radiography Workflow

These workflows become possible if you, the community stakeholders, incorporate pradformat readers/writers with your codes.

File Formats Overview

Each of the file formats are a subset of the HDF5 file format, and all share the ".h5" extension.

Format Description Example Use Cases
Simple Radiograph Processed radiograph flux image and metadata (mono-energetic, mono-species) Processed experimental or synthetic CR39, inputs for PROBLEM or PRaLine inversion algorithms. Share experimental or synthetic radiographs.
Advanced Radiograph Processed radiograph flux image and metadata (with multi-energy, multi-species sensitivity) Processed experimental or synthetic RCF layer or scintillator image, inputs to as-yet-unknown inversion algorithms. Share experimental or synthetic radiographs.
Simple Fields Uniform 3D spatial grid with basic field values for proton tracing Outputs from PIC/Hydro simulations, analytic fields, for inputs to a synthetic particle tracer. Share benchmark problems, like a turbulent plasma cube or a side-long current cylinder.
Particles List Long list of individual particles with varying positions and velocities Inputs or outputs from a synthetic particle tracer, storing customized particle sources. Share feature-filled TNSA sources, finite volume capsules with energy distributions.
Simple Inversion The numerical inversion of a Simple Radiograph (or, exact solutions to verify an inversion). Inverting a radiograph image to retrieve E & B fields in the object plane. Or, forward-projecting a E & B fields to verify numerical inversion techniques.

Each file format is defined by its specific layout of datasets, groups, and attributes within an HDF5 file. See the linked Format Specs of each for futher details.