Class MoMeshStreamline

  • All Implemented Interfaces:
    SafeDisposable

    public class MoMeshStreamline
    extends MoMeshRepresentation
    Rendering node that displays streamlines of a vector field on a volume mesh.

    Displays a list of MiLineMeshCurvilinear meshes containing streamlines starting from a list of source points and probes the input mesh to compute the values at the streamline nodes (See the "See Also" Section for settings).
    A streamline is a line that is everywhere tangent to a vector field. The vector field is specified by the vec3SetId field. This is an index into the list of vector sets existing in the traversal state (see the MoVec3Setxxx nodes).

    Note: Streamlines are meaningless for unsteady flow, because time is not taken into account during the computation of the lines. Streamlines are integrated from a given set of vectors using a Runge/Kutta method of order 2.

    The lines can be colored using a scalar set defined in the colorScalarSetId inherited field. This is an index into the list of scalar sets existing in the traversal state (see the MoScalarSetxxx nodes). To disable coloring set this field to -1.

    See Also:
    MiStreamlineExtractUnstructured, MiStreamlineExtractIjk, MiStreamlineExtractHexahedronIjk, MiPointProbeUnstructured, MiPointProbeIjk, MiPointProbeHexahedronIjk
    • Field Detail

      • vec3SetId

        public SoSFInt32 vec3SetId
        Field representing the vector set node to be used to compute the streamlines. During traversal of the scene graph, vector set nodes are accumulated in a list of vector sets. vec3SetId is an index in this list.
        The default value is 0 meaning to use the first set in the list.
      • startingPoints

        public SoMFVec3f startingPoints
        Starting points for the streamline computation.
        The default value is empty.
      • maxLifeTime

        public SoSFDouble maxLifeTime
        Sets the maximum life time of the streamline.
        The default value is 0, meaning infinite life time.
      • maxLength

        public SoSFDouble maxLength
        Sets the maximum length of the streamline.
        The default value is 0, meaning infinite length.
      • minSpeed

        public SoSFDouble minSpeed
        Sets the minimum speed of the streamline.
        The default value is 0, meaning no speed constraint.
      • integrationStepLengthFactor

        public SoSFDouble integrationStepLengthFactor
        Sets the step length factor for the streamline integration.
        The default value is 0.3.
      • maxStepNumber

        public SoSFInt32 maxStepNumber
        Sets the maximum step number during the streamline integration.
        The default value is 0, meaning infinite step number.
    • Constructor Detail

      • MoMeshStreamline

        public MoMeshStreamline()
        Constructs a rendering node with default values.
        • vec3SetId = 0
        • startingPoints is empty
        • maxLifeTime = 0
        • maxLength = 0
        • minSpeed = 0
        • integrationStepLengthFactor = 0.3
        • maxStepNumber = 0
        • direction = FORWARD
    • Method Detail

      • getUnstructuredExtractor

        public MiStreamlineExtractUnstructured getUnstructuredExtractor()
        Gets the streamline extractor for unstructured meshes to reuse outside this node.
        Note: The returned object may be null if no unstructured mesh has been set in the scene graph or if no render action has traversed the scene graph.
        Returns:
        the streamline extractor for unstructured meshes
      • getIjkExtractor

        public MiStreamlineExtractIjk getIjkExtractor()
        Gets the streamline extractor for IJK meshes to reuse outside this node.
        Note: The returned object may be null if no IJK mesh has been set in the scene graph or if no render action has traversed the scene graph.
        Returns:
        the streamline extractor for unstructured meshes
      • getHexahedronIjkExtractor

        public MiStreamlineExtractHexahedronIjk getHexahedronIjkExtractor()
        Gets the streamline extractor for hexahedron IJK meshes to reuse outside this node.
        Note: The returned object may be null if no hexahedron IJK mesh has been set in the scene graph or if no render action has traversed the scene graph.
        Returns:
        the streamline extractor for unstructured meshes