YAML schema for Chrono::FSI-TDPF simulation specification

A Chrono YAML TDPF simulation file defines the setup for a Chrono::FSI-TDPF simulation. It consists of the following main objects:

• [required] The Chrono version (chrono-version) that is compatible with the YAML model specification. This is a string of the form M.m (major.minor) or M.m.p (major-minor-patch), although only the two fileds are verified for compatibility.
• [required] The simulation type, which must be TDPF here.
• [required] The SPH model object which defines YAML specification of TDPF problem.
• [required] The SPH solver object which defines YAML specification of TDPF solver algorithms.
• [optional] The output object which specifies output options from the TDPF simulation.
• [optional] The visualization object which specifies TDPF-specific run-time visualization settings.

FSI-TDPF simulation specification

An FSI-TDPF simulation must specify the TDPF model to be simulated, as well as optional output and TDPF-specific run-time visualization settings.

Model and solver specification

The model entry (required) must specify the path (relative to the location of this YAML simulation specification file) to the YAML file with a TDPF model specification (which must follow the TDPF model schema).

The solver entry (required) must specify the path (relative to the location of this YAML simulation specification file) to the YAML file with a TDPF solver specification (which must follow the TDPF solver schema).

Output options

If the output key is present, it must specify a YAML object with the following properties:

Property	Description	Type	Available Values	Required	Default
type	Output DB type	enum	NONE,ASCII,HDF5	No	NONE
mode	Output mode	enum	FRAMES,SERIES	No	FRAMES
fps	Output frequency (FPS or Hz)	double	–	No	30

Visualization options

** TODO ** (TDPF-specific visualization options)

Example

Below is an example of an FSI-TDPF simulation configuration:

chrono-version: 9.0
type: TDPF
  
model:  "model_tdpf.yaml"
solver: "solver_tdpf.yaml"
 
output:
    type: NONE
    mode: FRAMES
    fps: 20
 
visualization:
  update_fps: 30
  color_map:
    type: HEIGHT
    map: BLUE
    min: -1.5
    max: 1.5
  output:
    save_images: false
    output_directory: "."
  

YAML schema

The YAML TDPF simulation specification file must follow the data/yaml/schema/fsitdpf_simulation.schema.yaml provided in the Chrono data directory:

# =============================================================================
# PROJECT CHRONO - http://projectchrono.org
#
# Copyright (c) 2025 projectchrono.org
# All rights reserved.
#
# Use of this source code is governed by a BSD-style license that can be found
# in the LICENSE file at the top level of the distribution and at
# http://projectchrono.org/license-chrono.txt.
# =============================================================================
#
# Schema for a Chrono::FSI-TDPF YAML fluid simulation specification file.
# The `chrono-version` must match the Chrono major and minor version numbers.
#
# =============================================================================
 
required: [chrono-version, type, model, solver]
 
chrono-version:
  type: string
  description: Chrono version compatible with this YAML specification (M.m or M.m.p)
 
# -----------------------------------------------------------------------------
# Definitions of common Chrono types
 
vector3d: &VECTOR3D   # Specification of a ChVector3d
    type: array
    items:
        type: number
    minItems: 3
    maxItems: 3
 
# -----------------------------------------------------------------------------
# Definition of a Chrono::FSI-TDPF simulation
 
type:
  description: Type of Chrono simulation (must be TDPF)
  type: string
  value: TDPF
 
model:
  description: |
      Model specification YAML file.
      The path to the model file must be provided relative to the location of this simulation specification file.
      The model file must follow the fsitdpf_model.schema.
  type: string
 
solver:
  description: |
      Solver specification YAML file
      The path to the solver file must be provided relative to the location of this simulation specification file.
      The solver file must follow the fsitdpf_solver.schema.
  type: string
 
output:
  description: Output settings
  type: object
  properties:
     type:
        type: string
        description: Output DB type
        enum: [NONE, ASCII, HDF5]
        default: NONE
     fps:
        type: number
        description: Output frequency
        minimum: 0
 
visualization:
  description: TDPF-specific run-time visualization settings (water surface visualization)
  type: object
  properties:
    update_fsp:
    color_map:
    output:
    # TODO