# Probe Outputs

Probe outputs in Flow360 allow you to track flow field variables at specific locations during the simulation, providing real-time feedback on how your solution is developing.

# 📋 Available Options

Option Description Unit
Name A descriptive name for the probe output
Output fields Flow variables to monitor at specified locations
Probes Points or point arrays where variables will be monitored

# 🔍 Detailed Descriptions

# Name

A user-defined name to identify this specific probe output configuration.

  • Default: Probe output
  • Example: Wing leading edge probes
  • Notes: Choose descriptive names to easily identify outputs when reviewing results.

# Output fields

The flow variables that will be monitored at the specified probe locations.

  • Default: None (user must select at least one field)
  • Example: primitiveVars, Cp, Mach
  • Notes: Select only the fields you need for your analysis.

# Probes

The specific points or arrays of points where flow variables will be monitored.

  • Default: None (user must define at least one probe)

  • Example: A point at (0, 1.5, 0), or a line of points between two locations

  • Notes: Points can be added individually or as arrays (lines) with evenly distributed points.

  • Adding Probes:

    • Click the "+" button or "Select from 3D scene or list" button in the Probes section
    • Choose "New point" to add a single probe point
    • Choose "New point array" to create a line of evenly spaced points

  • Point Definition:

    • Name: A unique identifier for the probe
    • Location: The 3D coordinates of the probe point

  • Point Array Definition:

    • Name: A unique identifier for the array
    • Start: The 3D coordinates of the start point
    • End: The 3D coordinates of the end point
    • Number of Points: How many points to place along the line

# 📊 Available Output Fields

# Universal Variables (for Probe Output)

  • Cp - Coefficient of pressure (non-dimensional)
  • Cpt - Coefficient of total pressure (non-dimensional)
  • gradW - Gradient of primitive solution (non-dimensional)
  • kOmega - k and omega (non-dimensional)
  • Mach - Mach number (non-dimensional)
  • mut - Turbulent viscosity (non-dimensional)
  • mutRatio - Turbulent viscosity and freestream dynamic viscosity ratio (non-dimensional)
  • nuHat - Spalart-Almaras variable (non-dimensional)
  • primitiveVars - Density, velocities (u,v,w), and pressure (non-dimensional)
  • qcriterion - Q criterion (non-dimensional)
  • residualNavierStokes - N-S residual (non-dimensional)
  • residualTransition - Transition residual (non-dimensional)
  • residualTurbulence - Turbulence residual (non-dimensional)
  • s - Entropy (non-dimensional)
  • solutionNavierStokes - N-S solution (non-dimensional)
  • solutionTransition - Transition solution (non-dimensional)
  • solutionTurbulence - Turbulence solution (non-dimensional)
  • T - Temperature (non-dimensional)
  • velocity - Velocity vector (non-dimensional)
  • velocity_x - X-component of velocity (non-dimensional)
  • velocity_y - Y-component of velocity (non-dimensional)
  • velocity_z - Z-component of velocity (non-dimensional)
  • velocity_magnitude - Magnitude of velocity vector (non-dimensional)
  • pressure - Pressure (non-dimensional)
  • vorticity - Vorticity (non-dimensional)
  • vorticityMagnitude - Vorticity Magnitude (non-dimensional)
  • wallDistance - Wall distance (non-dimensional)
  • numericalDissipationFactor - NumericalDissipationFactor sensor (non-dimensional)
  • residualHeatSolver - Heat equation residual (non-dimensional)
  • VelocityRelative - Velocity with respect to non-inertial frame (non-dimensional)
  • lowMachPreconditionerSensor - Low-Mach preconditioner factor (non-dimensional)

# Dimensioned Variables

  • velocity_m_per_s - Velocity vector (in m/s)
  • velocity_x_m_per_s - X-component of velocity (in m/s)
  • velocity_y_m_per_s - Y-component of velocity (in m/s)
  • velocity_z_m_per_s - Z-component of velocity (in m/s)
  • velocity_magnitude_m_per_s - Magnitude of velocity vector (in m/s)
  • pressure_pa - Pressure (in Pa)

# Additional Variables for Surface Probe Output

  • CfVec - Skin friction coefficient vector (non-dimensional)
  • Cf - Magnitude of skin friction coefficient (non-dimensional)
  • heatFlux - Non-dimensional heat flux (non-dimensional)
  • nodeNormals - Wall normals (non-dimensional)
  • nodeForcesPerUnitArea - Forces per unit area (non-dimensional)
  • yPlus - Non-dimensional wall distance (non-dimensional)
  • wallFunctionMetric - Wall function metrics (non-dimensional)
  • heatTransferCoefficientStaticTemperature - Surface heat transfer coefficient (static temperature as reference) (non-dimensional)
  • heatTransferCoefficientTotalTemperature - Surface heat transfer coefficient (total temperature as reference) (non-dimensional)
  • wall_shear_stress_magnitude - Wall shear stress magnitude (non-dimensional)
  • wall_shear_stress_magnitude_pa - Wall shear stress magnitude (in Pa)

# Surface Integral Output Fields

Surface Integral Output provides integrated values for forces and moments. Common outputs include:

  • PressureForce - Force due to pressure (non-dimensional)
  • ViscousForce - Force due to viscous stresses (non-dimensional)
  • TotalForce - Combined pressure and viscous forces (non-dimensional)
  • PressureMoment - Moment due to pressure forces (non-dimensional)
  • ViscousMoment - Moment due to viscous forces (non-dimensional)
  • TotalMoment - Combined pressure and viscous moments (non-dimensional)

💡 History Files

Probe outputs generate history files that track time-series data during simulations. These files are stored in CSV format and updated throughout the simulation, allowing for real-time monitoring and post-processing.

# Types of History Files

  • Standard Probe History Files

    • Probe outputs: Records flow variables at specified points in the volume
    • Surface probe outputs: Records flow variables at points projected onto surfaces
    • Surface integral outputs: Records integrated forces and moments on surfaces

  • Special Purpose History Files

    • Actuator Disk Output: Records thrust, torque, and power data for actuator disk models
    • BET Loading Output: Records force and moment data for blade element theory models
    • Heat Transfer: Records heat flux and temperature data

# Using History Files

History files can be used for:

  • Real-time monitoring of simulation progress
  • Convergence assessment
  • Time-series analysis
  • Frequency analysis (for unsteady simulations)
  • Verification and validation against experimental data

# Output Format

Probe data is saved in CSV format for easy plotting and analysis. The data is updated at the specified frequency during the simulation, allowing real-time monitoring of the solution progress.

❓ Frequently Asked Questions

  • What's the difference between Probe output and Surface Probe Output?

    Probe output monitors flow variables at exact 3D coordinates within the volume, while Surface Probe Output projects the specified points onto the nearest surface and monitors variables at those projected locations.

  • Can I monitor multiple variables at the same point?

    Yes, you can select multiple output fields for any monitor point or group of points.

  • How do I create a line of probe points?

    Use the "New point array" option when adding probes to create a line between two specified points with a chosen number of intermediate points.

  • Can I select probe points from the 3D scene?

    Yes, you can use the "Select from 3D scene or list" button in the Probes section to pick points visually from the 3D scene.

  • How do I integrate forces on a surface?

    Use Surface Integral Output with appropriate UserDefinedFields to calculate integrated forces and moments over surfaces.

  • How frequently are probe outputs updated?

    By default, probe outputs are updated at every iteration for steady simulations and at every time step for unsteady simulations.

🐍 Python Example Usage

# Probe Output Example

# Define a probe output with individual points and point arrays
probe_output = fl.ProbeOutput(
    name="probe_group_points_and_lines",
    entities=[  # The entities list corresponds to the 'Probes' section in the GUI
        fl.Point(
            name="Point_1",
            location=(0.0, 1.5, 0.0) * fl.u.m,
        ),
        fl.Point(
            name="Point_2",
            location=(0.0, -1.5, 0.0) * fl.u.m,
        ),
        fl.PointArray(
            name="Line_1",
            start=(1.0, 0.0, 0.0) * fl.u.m,
            end=(1.5, 0.0, 0.0) * fl.u.m,
            number_of_points=6,
        ),
        fl.PointArray(
            name="Line_2",
            start=(-1.0, 0.0, 0.0) * fl.u.m,
            end=(-1.5, 0.0, 0.0) * fl.u.m,
            number_of_points=3,
        ),
    ],
    output_fields=["primitiveVars"],
)

# Surface Probe Output Example

# Define a surface probe output
surface_probe_output = fl.SurfaceProbeOutput(
    name="surface_probe_group_points",
    entities=[
        fl.Point(
            name="Point_1",
            location=(0.0, 1.5, 0.0) * fl.u.m,
        ),
        fl.Point(
            name="Point_2",
            location=(0.0, -1.5, 0.0) * fl.u.m,
        ),
        fl.PointArray(
            name="Line_surface",
            start=(1.0, 0.0, 0.0) * fl.u.m,
            end=(1.0, 0.0, -10.0) * fl.u.m,
            number_of_points=11,
        ),
    ],
    target_surfaces=[
        geometry["wall"],
    ],
    output_fields=["heatFlux", "T"],
)

# Surface Integral Output Example

# Define a surface integral output
surface_integral_output = fl.SurfaceIntegralOutput(
    name="surface_integral",
    output_fields=["PressureForce"],
    entities=[volume_mesh["wing1"], volume_mesh["wing2"]],
)

← Time-Averaged Probe Outputs →