Mapping Parcel Data

In Simcenter STAR-CCM+, you can map the data available on Lagrangian Phases on to volume meshes. For this, the data mapper requires inputs such as the source Lagrangian phase and source field functions. It only maps the data available via field functions. The data mapper creates output field functions corresponding to the input field functions. These output field functions are available on the target regions in the volume mesh.

Parcel Data Mappers become available only when the Lagrangian Multiphase Model is selected. To map parcel data:

  1. Right click the Tools > Data Mappers node and select New Data Mapper > Parcel Data Mapper.
  2. Select the Parcel Data Mapper node and set the parcel data mapper properties (see Data Mapper Reference by Type):
    PropertyDescription
    Source PhasesThe Lagrangian phases to map from.
    Scalar FunctionsThe scalar field functions to map from parcels to the volume mesh.
    Vector FunctionsThe vector field functions to map from parcels to the volume mesh.
    Mapped NamesThe names of the output field functions.

    The default names of output field functions are <Data Mapper Name> + <Operator Name> + <Input Function Name>. Example: for Parcel Data Mapper 1, operator Average, field function Particle Diameter, the default name is ParcelDataMapper1AverageParticleDiameter.

    Each Parcel Data Mapper comes with a field function named <Data Mapper Name> + Parcel Count (for example, Parcel Data Mapper 1 Parcel Count). This field function gives the number of parcels of the input Lagrangian phases in each cell.

    RepresentationInput representation. Only the Volume Mesh representation is available.
    VerbositySelect for verbose output.
  3. Select Parcel Data Mapper > Target Specifications > Volume 1 and set the volume properties (see Target Reference):
    PropertyDescription
    Target RegionsThe volume meshes to map to.
    Mapping OperatorSelects the way the parcel data is mapped to the volume mesh. Available operators are:
    • Average: the average of the parcel data in any given cell.
    • Volume-Weighted Average: the volume-weighted average of the parcel data in any given cell.
    • Mass-Weighted Average: the mass-weighted average of the parcel data in any given cell.
    • Moment(3,2): gives the ratio of the third moment and the second moment of the input field function. The Moment(3,2) of Particle Diameter gives the Sauter Mean Diameter.
    • Variance: the weighted variance of the parcel field function in any given cell.
    • Sum: sums up the input field function over all the parcels of the input Lagrangian phases that lie in any given cell.
    • Minimum: gives the minimum of the input field function over the parcels in any given cell.
    • Maximum: gives the maximum of the input field function over the parcels in any given cell.
    It must be noted that for every cell in the target region, operator acts on all parcels of input phases in that cell.
  4. Select Parcel Data Mapper > Update and set Trigger and the properties of the child node under Update so that they match the update frequency of the Lagrangian solver.
  5. If you need more targets, right-click the Target Specifications node and select New Group to create another Volume node.
  6. If you need to identify cells that have at least one parcel in them, use the <Data Mapper Name> Parcel Count field function. Example:
    1. Define a quantity called $NAN_VALUE which is the value when there are no parcels.
    2. Create another function defined as: VISUALIZED_VALUE = $ParcelDataMapper1ParcelCount > 0 ? $MAPPED_VALUE : NAN_VALUE.
      This can be used to visualize the minimum or maximum values of parcel count.
  7. If you want to register field functions without performing the mapping:
    1. Right-click the Data Mappers node and select Pre-Register Mapped Fields.
    2. Right-click the Parcel Data Mapper node for the field functions and select Map Data.
    Pre-registration is useful for setting up other post-processing aids such as scenes, plots, or monitors, using the mapped field functions.