luminarycloud.vis¶
Attributes¶
Classes¶
This class defines a box used for filter such as box clip. |
|
Clip the dataset using a box. Cells inside the box are kept while cells completely outside the |
|
Directional camera options |
|
The type of projection used in the camera. |
|
The color map allows user control over how field values are mapped to |
|
ColorMapAppearance controls how the color maps appear in the image, including |
|
Predefined color map presets. |
|
Predefined color map presets. |
|
The data range represents a range of values. Ranges are only valid if the |
|
Class defining a directional camera for visualization. Directional |
|
Display attributes specify how objects such as meshes, geometries, and |
|
An enum for specifying the source of an image. When listing extracts, |
|
An enum for specifying the source of an image. When listing extracts, |
|
The field controls the field displayed on the object. If the field doesn't |
|
Specifies which component of a field is used for visualization. |
|
Specifies which component of a field is used for visualization. |
|
Vector Glyphs is a vector field visualization techique that places arrows (e.g., glyphs), |
|
The InteractiveScene acts as the bridge between the the Scene and |
|
Isosurface is used to evaluate scalar fields at constant values, known as |
|
Class defining a look at camera for visualization. Unlike the directional |
|
This class defines a plane. |
|
Clip the dataset using a plane. Cells in the direction of the plane normal |
|
Streamlines is a vector field visualization technique that integrates |
|
The render output represents the request to render images from a geometry, mesh or |
|
Represents the status of a rendering request. |
|
The representation defines how objects will appear in the scene. |
|
The representation defines how objects will appear in the scene. |
|
Vector Glyphs is a vector field visualization techique that places arrows |
|
The scene class is the base for any visualization. The scene is constructed |
|
The slice filter is used to extract a cross-section of a 3D dataset by |
|
An enum for specifying the integration direction for streamlines filters. |
|
An enum for specifying the streamline behavior for SurfaceStreamlines. |
|
Streamlines is a vector field visualization technique that integrates |
|
The threshold filter used to remove cells based on a data range. Cells with values |
|
Represents a 3-dimensional vector. |
|
The visualization quantity. This is a subset of all quantities. |
Functions¶
|
List the quantity types, including derived quantities, that are available in |
|
Lists all previously created renders associated with a project and an entity. |
|
Package Contents¶
- class luminarycloud.vis.Box¶
This class defines a box used for filter such as box clip. .. warning:: This feature is experimental and may change or be removed in the future.
- angles: luminarycloud.types.Vector3Like¶
- center: luminarycloud.types.Vector3Like¶
- lengths: luminarycloud.types.Vector3Like¶
- class luminarycloud.vis.BoxClip(name: str)¶
Bases:
Filter
Clip the dataset using a box. Cells inside the box are kept while cells completely outside the box are removed.
Warning
This feature is experimental and may change or be removed in the future.
- get_parent_id() str ¶
Returns the filter’s parent id. An empty string will be returned if there is no parent.
- reset_parent() None ¶
Reset the parent of this filter to the original dataset.
- set_parent(filter: Any) None ¶
Set this filter’s parent filter. This controls what data the filter uses as input. Filters can be chained into a DAG. If no parent is set, then this filter uses the original dataset.
- Parameters:
- filter: Filter
The filter to use as the parent.
- display_attrs¶
- id¶
- inverted: bool = True¶
- name¶
- class luminarycloud.vis.CameraDirection¶
Bases:
enum.IntEnum
Directional camera options
- Attributes:
- X_POSITIVE
Look down the positive x-axis
- Y_POSITIVE
Look down the positive y-axis
- Z_POSITIVE
Look down the positive z-axis
- X_NEGATIVE
Look down the negative x-axis
- Y_NEGATIVE
Look down the negative y-axis
- Z_NEGATIVE
Look down the negative z-axis
- X_NEGATIVE¶
- X_POSITIVE¶
- Y_NEGATIVE¶
- Y_POSITIVE¶
- Z_NEGATIVE¶
- Z_POSITIVE¶
- class luminarycloud.vis.CameraProjection¶
Bases:
enum.IntEnum
The type of projection used in the camera.
- Attributes:
- ORTHOGRAPHIC
A orthographic (i.e., parallel) projection.
- PERSPECTIVE
A perspective projection.
- ORTHOGRAPHIC¶
- PERSPECTIVE¶
- class luminarycloud.vis.ColorMap¶
The color map allows user control over how field values are mapped to colors. Color maps are assigned to fields (e.g., the quantity and component) and not individual display attributes. This means that there can only ever be one color map per field/component combination (e.g., velocity-magnitude or velocity-x). Any display attribute in the scene (i.e., filter display attributes or global display attributes) that maps to this color map will be color in the same manner.
Warning
This feature is experimental and may change or be removed in the future.
- Attributes:
- fieldField
The field and component this color map applies to.
- presetColorMapPreset
The color map preset to use. This defines the colors used in the color map. Default is ‘JET’.
- data_rangeDataRange
An optional data range to use for the color map. The user must explicity set the data ranges. If not set explicitly, the fields global data range is used. For comparing multiple results, either with different solutions in the same simulation or with different simulations, its highly recommended that a range is provided so the color scales are the same between the resulting images. Default: is an invalid data range.
- discretizebool
Use discrete color bins instead of a continuous range. When True, ‘n_colors’ indicates how many discrete bins to use. Default: False.
- n_colorsint
How many discrete bins to use when discretize is True. Valid n_colors values are [1, 256]. Default: 8.
- appearance: Optional[ColorMapAppearance]
This attribute controls how the color map annotation appears in the image, including location, size, and visibility. When the scene is set to automatic color maps, these attributes are automatically populated unless overridden. When setting the appearance, the user is responsible for setting all values.
- appearance: ColorMapAppearance | None = None¶
- discretize: bool = False¶
- n_colors: int = 8¶
- preset: ColorMapPreset¶
- class luminarycloud.vis.ColorMapAppearance¶
ColorMapAppearance controls how the color maps appear in the image, including visibility, position and size.
The width, height, and the lower left position of the color map are specified in normalized device coordinates. These are values in the [0,1] range. For example, the lower left hand coordinate of the image is [0,0], and the top right coordinate of the image is [1,1].
Warning
This feature is experimental and may change or be removed in the future.
- Attributes:
- visible: bool
Controls if the color map is displayed or not. Default: True
- width: float
The width of the color map in normalized device coordinates. Default: 0.034
- height: float
The height of the color map in normalized device coordinates. Default: 0.146
- text_size: int
The text size for the color map legend in pixels. Default: 36
- lower_left_x: float
The lower left x position of the color map in normalized device coordinates. Default: 0.8
- lower_left_y: float
The lower left y position of the color map in normalized device coordinates. Default: 0.8
- height: float = 0.146¶
- lower_left_x: float = 0.8¶
- lower_left_y: float = 0.8¶
- text_size: int = 36¶
- visible: bool = True¶
- width: float = 0.034¶
- class luminarycloud.vis.ColorMapPreset¶
Bases:
enum.IntEnum
Predefined color map presets.
- COOL_TO_WARM¶
- JET¶
- TURBO¶
- VIRIDIS¶
- WAVE¶
- XRAY¶
- class luminarycloud.vis.ColorMapPreset¶
Bases:
enum.IntEnum
Predefined color map presets.
- COOL_TO_WARM¶
- JET¶
- TURBO¶
- VIRIDIS¶
- WAVE¶
- XRAY¶
- class luminarycloud.vis.DataRange¶
The data range represents a range of values. Ranges are only valid if the max value is greater than the or equal to the min_value. The default is invalid.
Warning
This feature is experimental and may change or be removed in the future.
- is_valid() bool ¶
- max_value: float¶
- min_value: float¶
- class luminarycloud.vis.DirectionalCamera¶
Class defining a directional camera for visualization. Directional camera are oriented around the visible objects in the scene and will always face towards the scene.
Warning
This feature is experimental and may change or be removed in the future.
- direction: CameraDirection¶
- height: int = 1024¶
- label: str = ''¶
- name: str = 'default directional camera'¶
- projection: CameraProjection¶
- width: int = 1024¶
- class luminarycloud.vis.DisplayAttributes¶
Display attributes specify how objects such as meshes, geometries, and filters appear in the scene.
Warning
This feature is experimental and may change or be removed in the future.
Attributes:¶
- visiblebool
If the object is visible or not. Default: True
- opacityfloat
How opaque the object is. This is a normalized number between 0 (i.e., fully transparent) and 1 (i.e., fully opaque). Default: 1
- fieldField
What field quantity/component to color by, if applicable.
- representationRepresentation
how the object is represented in the scene (e.g., surface, surface with edges, wireframe or points). Default: surface.
- opacity: float = 1.0¶
- representation: Representation¶
- visible: bool = True¶
- class luminarycloud.vis.EntityType¶
Bases:
enum.IntEnum
An enum for specifying the source of an image. When listing extracts, the user must specify what type of extract they are interested in. This enum is only used by the visualization code.
Warning
This feature is experimental and may change or be removed in the future.
- Attributes:
- SIMULATION
Specifies a similuation entity (i.e., a result).
- MESH
Specifies a mesh entity.
- GEOMETRY
Specifies a geometry entity.
- GEOMETRY = 2¶
- MESH = 1¶
- SIMULATION = 0¶
- class luminarycloud.vis.EntityType¶
Bases:
enum.IntEnum
An enum for specifying the source of an image. When listing extracts, the user must specify what type of extract they are interested in. This enum is only used by the visualization code.
Warning
This feature is experimental and may change or be removed in the future.
- Attributes:
- SIMULATION
Specifies a similuation entity (i.e., a result).
- MESH
Specifies a mesh entity.
- GEOMETRY
Specifies a geometry entity.
- GEOMETRY = 2¶
- MESH = 1¶
- SIMULATION = 0¶
- class luminarycloud.vis.Field¶
The field controls the field displayed on the object. If the field doesn’t exist, we show a solid color.
Warning
This feature is experimental and may change or be removed in the future.
- component: FieldComponent¶
- quantity: VisQuantity¶
- class luminarycloud.vis.FieldComponent¶
Bases:
enum.IntEnum
Specifies which component of a field is used for visualization. When using scalars, the X component is the only valid component.
Warning
This feature is experimental and may change or be removed in the future.
- MAGNITUDE¶
- X¶
- Y¶
- Z¶
- class luminarycloud.vis.FieldComponent¶
Bases:
enum.IntEnum
Specifies which component of a field is used for visualization. When using scalars, the X component is the only valid component.
Warning
This feature is experimental and may change or be removed in the future.
- MAGNITUDE¶
- X¶
- Y¶
- Z¶
- class luminarycloud.vis.FixedSizeVectorGlyphs(name: str)¶
Bases:
VectorGlyphs
Vector Glyphs is a vector field visualization techique that places arrows (e.g., glyphs), in the 3D scene that are oriented in the direction of the underlying vector field. Fixed size vector glyhs places vector annotations at sampled points in meshes that are a fixed size. This filter is only valid on vector fields. .. warning:: This feature is experimental and may change or be removed in the future.
- get_parent_id() str ¶
Returns the filter’s parent id. An empty string will be returned if there is no parent.
- reset_parent() None ¶
Reset the parent of this filter to the original dataset.
- set_parent(filter: Any) None ¶
Set this filter’s parent filter. This controls what data the filter uses as input. Filters can be chained into a DAG. If no parent is set, then this filter uses the original dataset.
- Parameters:
- filter: Filter
The filter to use as the parent.
- display_attrs¶
- field: luminarycloud.vis.display.Field¶
- id¶
- name: str¶
- property sampling_rate: int¶
- size: float = 1.0¶
- class luminarycloud.vis.InteractiveScene(scene: luminarycloud.vis.visualization.Scene)¶
The InteractiveScene acts as the bridge between the the Scene and the Jupyter widget, handling checking if we have the widget package before passing calls to the widget to handle it being an optional dependency
- get_camera() luminarycloud.vis.visualization.LookAtCamera ¶
- reset_camera() None ¶
- set_display_attributes(object_id: str, attrs: luminarycloud.vis.display.DisplayAttributes) None ¶
- set_scene(scene: luminarycloud.vis.visualization.Scene) None ¶
- set_surface_color(surface_id: str, color: list[float]) None ¶
- set_surface_visibility(surface_id: str, visible: bool) None ¶
- widget¶
- class luminarycloud.vis.Isosurface(name: str)¶
Bases:
Filter
Isosurface is used to evaluate scalar fields at constant values, known as isovalues. In volumes, isosurface produces surfaces, and in surfaces, isosurface produces lines (isolines). Isosurface is also known as contouring and as level-sets.
Warning
This feature is experimental and may change or be removed in the future.
- get_parent_id() str ¶
Returns the filter’s parent id. An empty string will be returned if there is no parent.
- reset_parent() None ¶
Reset the parent of this filter to the original dataset.
- set_parent(filter: Any) None ¶
Set this filter’s parent filter. This controls what data the filter uses as input. Filters can be chained into a DAG. If no parent is set, then this filter uses the original dataset.
- Parameters:
- filter: Filter
The filter to use as the parent.
- display_attrs¶
- field: luminarycloud.vis.display.Field¶
- id¶
- isovalues: List[float] = []¶
- name¶
- class luminarycloud.vis.LookAtCamera¶
Class defining a look at camera for visualization. Unlike the directional camera which is placed relative to what is visisble, the the look at camera is an explict camera, meaning that we have to fully specify the parameters.
Warning
This feature is experimental and may change or be removed in the future.
- height: int = 1024¶
- label: str = ''¶
- look_at: luminarycloud.types.Vector3Like¶
- position: luminarycloud.types.Vector3Like¶
- projection: CameraProjection¶
- up: luminarycloud.types.Vector3Like¶
- width: int = 1024¶
- class luminarycloud.vis.Plane¶
This class defines a plane.
Warning
This feature is experimental and may change or be removed in the future.
- normal: luminarycloud.types.Vector3Like¶
- origin: luminarycloud.types.Vector3Like¶
- class luminarycloud.vis.PlaneClip(name: str)¶
Bases:
Filter
Clip the dataset using a plane. Cells in the direction of the plane normal are kept, while the cells in the opposite direction are removed.
Warning
This feature is experimental and may change or be removed in the future.
- get_parent_id() str ¶
Returns the filter’s parent id. An empty string will be returned if there is no parent.
- reset_parent() None ¶
Reset the parent of this filter to the original dataset.
- set_parent(filter: Any) None ¶
Set this filter’s parent filter. This controls what data the filter uses as input. Filters can be chained into a DAG. If no parent is set, then this filter uses the original dataset.
- Parameters:
- filter: Filter
The filter to use as the parent.
- display_attrs¶
- id¶
- inverted: bool = False¶
- name¶
- class luminarycloud.vis.RakeStreamlines(name: str)¶
Bases:
Streamlines
Streamlines is a vector field visualization technique that integrates massless particles through a vector field forming curves. Streamlines are used to visualize and analyze fluid flow patterns (e.g., the velocity field), helping to understand how the fluid moves. Streamlines can be use used to visualize any vector field contained in the solution.
RakeStreamlines generates seed particles evenly spaced along a line defined by specified start and end points. RakeStreamlines only work with volume data.
Warning
This feature is experimental and may change or be removed in the future.
- get_parent_id() str ¶
Returns the filter’s parent id. An empty string will be returned if there is no parent.
- reset_parent() None ¶
Reset the parent of this filter to the original dataset.
- set_parent(filter: Any) None ¶
Set this filter’s parent filter. This controls what data the filter uses as input. Filters can be chained into a DAG. If no parent is set, then this filter uses the original dataset.
- Parameters:
- filter: Filter
The filter to use as the parent.
- direction: luminarycloud.enum.vis_enums.StreamlineDirection¶
- display_attrs¶
- end: luminarycloud.types.Vector3Like¶
- field: luminarycloud.vis.display.Field¶
- id¶
- max_length: float = 10¶
- n_streamlines: int = 100¶
- name: str¶
- start: luminarycloud.types.Vector3Like¶
- class luminarycloud.vis.RenderOuptut(extract_id: str, project_id: str, name: str, desciption: str, status: RenderStatusType)¶
The render output represents the request to render images from a geometry, mesh or solution. The operation exectutes asyncronously, so the caller must check the status of the image extract. If the status is completed, then the resuling image is available for download.
Warning
This feature is experimental and may change or be removed in the future.
- delete() None ¶
Delete the image.
- download_images() List[Tuple[io.BytesIO, str]] ¶
Downloads the resulting jpeg images into binary buffers. This is useful for displaying images in notebooks. If that status is not complete, an error will be raised.
- Returns:
List[Tuple[io.BytesIO, str]]: a list of tuples containing the binary image data and the user provided image label (camera.label).
Warning
This feature is experimental and may change or be removed in the future.
- refresh() RenderOutput ¶
Refesh the status of the RenderOutput.
- Returns:
- self
- save_images(file_prefix: str, write_labels: bool = False) None ¶
A helper for downloading and save resulting images to the file system. If that status is not complete, an error will be raised. Images will be of the form {file_prefix}_{index}.jpg. Optionally, a file will be written containing a list of file names and image labels. Labels are an optional field in the camera (camera.label).
Warning
This feature is experimental and may change or be removed in the future.
- Parameters:
- file_prefix: str, required
The file prefix to save the image. A image index and ‘.jpg’ will be appended to the file names.
- write_labels: bool, optional
Write a json file containing a list of image file names and labels, if True. The resulting json file is named ‘{file_prefix}.json’ Default: False
- wait(interval_seconds: float = 5, timeout_seconds: float = float('inf')) RenderStatusType ¶
Wait until the RenderOutput is completed or failed.
- Parameters:
- intervalfloat, optional
Number of seconds between polls.
- timeoutfloat, optional
Number of seconds before timeout.
- Returns:
- RenderStatusType: Current status of the image extract.
- description: str¶
- name: str¶
- status: RenderStatusType¶
- class luminarycloud.vis.RenderStatusType¶
Bases:
enum.IntEnum
Represents the status of a rendering request.
Warning
This feature is experimental and may change or be removed in the future.
- Attributes:
- ACTIVE
The request is currently active and being processed.
- COMPLETED
The request is complete.
- FAILED
The request has failed.
- INVALID
The request is invalid.
- ACTIVE¶
- COMPLETED¶
- FAILED¶
- INVALID¶
- class luminarycloud.vis.Representation¶
Bases:
enum.IntEnum
The representation defines how objects will appear in the scene.
Warning
This feature is experimental and may change or be removed in the future.
- POINTS¶
- SURFACE¶
- SURFACE_WITH_EDGES¶
- WIREFRAME¶
- class luminarycloud.vis.Representation¶
Bases:
enum.IntEnum
The representation defines how objects will appear in the scene.
Warning
This feature is experimental and may change or be removed in the future.
- POINTS¶
- SURFACE¶
- SURFACE_WITH_EDGES¶
- WIREFRAME¶
- class luminarycloud.vis.ScaledVectorGlyphs(name: str)¶
Bases:
VectorGlyphs
Vector Glyphs is a vector field visualization techique that places arrows (e.g., glyphs), in the 3D scene that are oriented in the direction of the underlying vector field. Scaled vector glyphs changes the size of the arrows base on the magnitude of the vector. For example when visualizing the velocity field, a glyph where the magnitude is twice the magnitude of another glyph will appear twice as large. .. warning:: This feature is experimental and may change or be removed in the future.
- get_parent_id() str ¶
Returns the filter’s parent id. An empty string will be returned if there is no parent.
- reset_parent() None ¶
Reset the parent of this filter to the original dataset.
- set_parent(filter: Any) None ¶
Set this filter’s parent filter. This controls what data the filter uses as input. Filters can be chained into a DAG. If no parent is set, then this filter uses the original dataset.
- Parameters:
- filter: Filter
The filter to use as the parent.
- display_attrs¶
- field: luminarycloud.vis.display.Field¶
- id¶
- name: str¶
- property sampling_rate: int¶
- scale: float = 1.0¶
- class luminarycloud.vis.Scene(entity: luminarycloud.geometry.Geometry | luminarycloud.mesh.Mesh | luminarycloud.solution.Solution)¶
The scene class is the base for any visualization. The scene is constructed with what “entity” you want to visualize: a solution, a mesh, or a geometry.
Global display attributes: The global display attributes control the default appearance of all the surfaces (i.e. boundaries). Attributes include visibitiy, what fields are displayed on the surfaces (if applicable), and representation (e.g., surface, surface with edges, …).
Individual surface visibilities can be overidden to hide/show specific surfaces. Additionally, if the scene is constructed around a simulation, a helper method is provided to automatically hide surfaces associated with far fields.
Warning
This feature is experimental and may change or be removed in the future.
- add_camera(camera: DirectionalCamera | LookAtCamera) None ¶
Add a camera to the scene. Each camera added produces an image.
- add_color_map(color_map: luminarycloud.vis.display.ColorMap) None ¶
Add a color map to the scene. If a color map with the field already exists, it will be overwritten.
- add_filter(filter: luminarycloud.vis.filters.Filter) None ¶
Add a filter to the scene. Filters not currently supported with geometries and will raise an error if added.
- hide_far_field() None ¶
Hide all far fields surfaces based on simulation parameters. Will work if the entity is a simulation.
- interact() luminarycloud.vis.interactive_scene.InteractiveScene ¶
Start an interactive display of the scene, when running inside LuminaryCloud’s AI Notebook environment or Jupyter Lab. The returned object must be displayed in the notebook to display the interactive visualization. This requires that the luminarycloud package was installed with the optional jupyter feature.
- render_images(name: str, description: str) RenderOutput ¶
Create a request to render a images of the scene using the scene’s cameras.
- Parameters:
- namestr
A short name for the the renders.
- descriptionstr
A longer description of the scene and renderings.
- surface_ids() List[str] ¶
Get a list of all the surface ids associated with the mesh.
- surface_visibility(surface_id: str, visible: bool) None ¶
Explicitly override the the visibility of a surface by id. When caclulating final visibilities, we first apply overrides to the global display attributes using tags, then surface ids.
- tag_ids() List[str] ¶
Get a list of all the tag ids associated with the entity.
- tag_visibility(tag_id: str, visible: bool) None ¶
Explicitly override the the visibility based on tag id. When caclulating final visibilities, we first apply overrides to the global display attributes using tags, then surface ids.
- auto_color_map_annotations = True¶
- axes_grid_visible: bool = True¶
- background_color: luminarycloud.types.Vector3¶
- global_display_attrs¶
- triad_visible: bool = True¶
- class luminarycloud.vis.Slice(name: str)¶
Bases:
Filter
The slice filter is used to extract a cross-section of a 3D dataset by slicing it with a plane.
Warning
This feature is experimental and may change or be removed in the future.
- get_parent_id() str ¶
Returns the filter’s parent id. An empty string will be returned if there is no parent.
- reset_parent() None ¶
Reset the parent of this filter to the original dataset.
- set_parent(filter: Any) None ¶
Set this filter’s parent filter. This controls what data the filter uses as input. Filters can be chained into a DAG. If no parent is set, then this filter uses the original dataset.
- Parameters:
- filter: Filter
The filter to use as the parent.
- display_attrs¶
- id¶
- name¶
- property project_vectors: bool¶
- class luminarycloud.vis.StreamlineDirection¶
Bases:
enum.IntEnum
An enum for specifying the integration direction for streamlines filters.
Warning
This feature is experimental and may change or be removed in the future.
- Attributes:
- FORWARD
Integrate streamlines in the direction of the vector field. Use this option when you want to see where a particle travels in the vector field given an initial position.
- BACKWARDS
Integrate streamlines in the opposite direction of the vector field. Use this option when you want to see where a particle came from in the vector field given the final position.
- BOTH
Integrate streamlines in the both directions in the vector field. Use this option whe you want to see both where the particle came from and where it travels given an initial position.
- BACKWARD¶
- BOTH¶
- FORWARD¶
- class luminarycloud.vis.SurfaceStreamlineMode¶
Bases:
enum.IntEnum
An enum for specifying the streamline behavior for SurfaceStreamlines.
Warning
This feature is experimental and may change or be removed in the future.
- Attributes:
- ADVECT_ON_SURFACE
Particle advection is constrained to the surfaces of the mesh.
- ADVECT_IN_VOLUME
Use points on surfaces to seed particle advection in the volume.
- ADVECT_IN_VOLUME = 1¶
- ADVECT_ON_SURFACE = 0¶
- class luminarycloud.vis.SurfaceStreamlines(name: str)¶
Bases:
Streamlines
Streamlines is a vector field visualization technique that integrates massless particles through a vector field forming curves. Streamlines are used to visualize and analyze fluid flow patterns (e.g., the velocity field), helping to understand how the fluid moves. Streamlines can be use used to visualize any vector field contained in the solution.
- Surface streamlines has two different modes:
ADVECT_ON_SURFACE: constrain particles to the surfaces of the mesh.
ADVECT_IN_VOLUME: use surface points to seed volumetric streamlines.
The advection mode also effects what fields can be used. For example, velocity is zero on walls, so when useing ADVECT_ON_SURFACE use a field that has non-zero values such as wall shear stress.
- Example use cases for ADVECT_IN_VOLUME:
placing seeds on an inlet surface and integrating in the forwared direction.
placing seeds on an outlet surface and integrating in the backward direction.
placing seeds on the tires of a car or on the wing of an airplane.
- Example use cases for ADVECT_ON_SURFACE:
Understanding forces on walls such as wall shear stress.
Warning
This feature is experimental and may change or be removed in the future.
- add_surface(id: str) None ¶
Add a surface to generate seed points from.
- Parameters:
- id: str
A surface id or a tag id.
- get_parent_id() str ¶
Returns the filter’s parent id. An empty string will be returned if there is no parent.
- reset_parent() None ¶
Reset the parent of this filter to the original dataset.
- set_parent(filter: Any) None ¶
Set this filter’s parent filter. This controls what data the filter uses as input. Filters can be chained into a DAG. If no parent is set, then this filter uses the original dataset.
- Parameters:
- filter: Filter
The filter to use as the parent.
- direction: luminarycloud.enum.vis_enums.StreamlineDirection¶
- display_attrs¶
- field: luminarycloud.vis.display.Field¶
- id¶
- max_length: float = 10¶
- mode: luminarycloud.enum.vis_enums.SurfaceStreamlineMode¶
- n_streamlines: int = 100¶
- name: str¶
- offset: float = 0.0¶
- sampling_rate = 100¶
- class luminarycloud.vis.Threshold(name: str)¶
Bases:
Filter
The threshold filter used to remove cells based on a data range. Cells with values within the range (i.e., min_value and max_value), are kept. All other cells are removed.
Warning
This feature is experimental and may change or be removed in the future.
- get_parent_id() str ¶
Returns the filter’s parent id. An empty string will be returned if there is no parent.
- reset_parent() None ¶
Reset the parent of this filter to the original dataset.
- set_parent(filter: Any) None ¶
Set this filter’s parent filter. This controls what data the filter uses as input. Filters can be chained into a DAG. If no parent is set, then this filter uses the original dataset.
- Parameters:
- filter: Filter
The filter to use as the parent.
- display_attrs¶
- field: luminarycloud.vis.display.Field¶
- id¶
- invert: bool = False¶
- max_value: float = 1.0¶
- min_value: float = 0.0¶
- name: str¶
- smooth: bool = False¶
- strict: bool = False¶
- class luminarycloud.vis.Vector3¶
Represents a 3-dimensional vector.
- x: float = 0.0¶
- y: float = 0.0¶
- z: float = 0.0¶
- class luminarycloud.vis.VisQuantity¶
Bases:
enum.IntEnum
The visualization quantity. This is a subset of all quantities.
Warning
This feature is experimental and may change or be removed in the future.
- ABSOLUTE_PRESSURE¶
- ADJOINT_N_TILDE¶
- ADJOINT_RE_THETA¶
- DENSITY¶
- EDDY_VISCOSITY¶
- ENERGY_FLUX¶
- GAMMA¶
- GRID_VELOCITY¶
- HEAT_FLUX¶
- HEAT_TRANSFER_COEFFICIENT¶
- MACH¶
- MASS_FLUX¶
- NONE¶
- NORMAL_SENSITIVITY¶
- N_TILDE¶
- OMEGA¶
- PRESSURE¶
- PRESSURE_COEFFICIENT¶
- Q_CRITERION¶
- RELATIVE_MACH¶
- RELATIVE_VELOCITY¶
- RE_ROUGHNESS¶
- RE_THETA¶
- SA_VARIABLE¶
- SENSITIVITY¶
- SKIN_FRICTION_COEFFICIENT¶
- SMOOTHED_NORMAL_SENSITIVITY¶
- TEMPERATURE¶
- TKE¶
- TOTAL_PRESSURE¶
- TOTAL_PRESSURE_COEFFICIENT¶
- TOTAL_TEMPERATURE¶
- VELOCITY¶
- VISCOSITY¶
- WALL_SHEAR_STRESS¶
- Y_PLUS¶
- luminarycloud.vis.list_quantities(solution: luminarycloud.solution.Solution) List[VisQuantity] ¶
List the quantity types, including derived quantities, that are available in a solution.
Warning
This feature is experimental and may change or be removed in the future.
- Parameters:
- solution: Solution
The the solution object to query.
- luminarycloud.vis.list_renders(entity: luminarycloud.geometry.Geometry | luminarycloud.mesh.Mesh | luminarycloud.solution.Solution) List[RenderOutput] ¶
Lists all previously created renders associated with a project and an entity.
Warning
This feature is experimental and may change or be removed in the future.
- Parameters:
- project_idstr
The project id to query.
- entityGeometry | Mesh | Solution
Specifies what types of rendering extracts to list(e.g., geometry, mesh or solution).
- luminarycloud.vis.visquantity_text(quantity: VisQuantity) str ¶