Dye Regions

Used for fluid motion tracking.

In a simulation, dye regions can be defined with the same or different colors. As a fluid particle (without respect to its phase definition/density) passes through a dye region it is assigned that regions defined color (integer, scalar property which is then output in the particle data). The use of dye regions eliminates the need of using multiple FLUID phase definitions to track the fluid flow from a specific location.
Note:
  • Dye regions can only be spherical in shape.
  • If a particle passes through multiple dye regions, it will adopt the color of the last dye region through which it passed.

Commands

dyeRegions
{
    dyeRegion
    {
        dyeregion_clr           1                           
        dyeregion_cntr          "0.0 0.1 0.2"               
        dyeregion_rad           0.1                         
        dyeregion_radodx        2.5                         
        dyeregion_tstart        0.0                         
        dyeregion_tend          1.0                         
    }
}

Definitions

Command Contents SI Unit Example
dyeregion_clr Color assigned to the dye region
dyeregion_cntr Center coordinates of the dye region sphere [m]
dyeregion_rad Radius of the dye region sphere [m]
dyeregion_radodx Radius of the dye region sphere as a function of d x MathType@MTEF@5@5@+= feaahqart1ev3aaatCvAUfeBSjuyZL2yd9gzLbvyNv2CaerbuLwBLn hiov2DGi1BTfMBaeXatLxBI9gBaerbd9wDYLwzYbItLDharqqtubsr 4rNCHbGeaGqiVu0Je9sqqrpepC0xbbL8F4rqqrFfpeea0xe9Lq=Jc9 vqaqpepm0xbba9pwe9Q8fs0=yqaqpepae9pg0FirpepeKkFr0xfr=x fr=xb9adbaqaaeGaciGaaiaabeqaamaabaabaaGcbaGaamizaiaadI haaaa@37D9@
Tip: For example, when specified 3.0, this implies 3.0 * d x MathType@MTEF@5@5@+= feaahqart1ev3aaatCvAUfeBSjuyZL2yd9gzLbvyNv2CaerbuLwBLn hiov2DGi1BTfMBaeXatLxBI9gBaerbd9wDYLwzYbItLDharqqtubsr 4rNCHbGeaGqiVu0Je9sqqrpepC0xbbL8F4rqqrFfpeea0xe9Lq=Jc9 vqaqpepm0xbba9pwe9Q8fs0=yqaqpepae9pg0FirpepeKkFr0xfr=x fr=xb9adbaqaaeGaciGaaiaabeqaamaabaabaaGcbaGaaG4maiaac6 cacaaIWaGaaiOkaiaadsgacaWG4baaaa@3AB0@ .
Note: If both dyeregion_rad and dyeregion_radodx are present, the latter takes precedence.
dyeregion_tstart Start time of dye injection [s]
dyeregion_tend End time of dye injection [s]