warp.fem.Hexmesh#

class warp.fem.Hexmesh( hex_vertex_indices, positions, assume_parallelepiped_cells=False, build_bvh=False, temporary_store=None, )[source]#

Hexahedral mesh geometry.

Parameters:

hex_vertex_indices (array)
positions (array)
build_bvh (bool)
temporary_store (TemporaryStore | None)

__init__( hex_vertex_indices, positions, assume_parallelepiped_cells=False, build_bvh=False, temporary_store=None, )[source]#

Construct a hexahedral mesh.

Parameters:

hex_vertex_indices (array) – warp array of shape (num_hexes, 8) containing vertex indices for each hex following standard ordering (bottom face vertices in counter-clockwise order, then similarly for upper face)
positions (array) – warp array of shape (num_vertices, 3) containing 3d position for each vertex
assume_parallelepiped – If true, assume that all cells are parallelepipeds (cheaper position/gradient evaluations)
build_bvh (bool) – Whether to also build the hex BVH, which is necessary for the global fem.lookup operator
temporary_store (TemporaryStore | None) – shared pool from which to allocate temporary arrays

Methods

`__init__`(hex_vertex_indices, positions[, ...])	Construct a hexahedral mesh.
`boundary_side_count`()	Number of boundary sides in the mesh.
`build_bvh`([device])	Rebuild the geometry's Bounding Volume Hierarchy (BVH) for `device` from scratch.
`bvh_id`(device)	Return the BVH identifier for the given device, or `0` if unavailable.
`cell_arg_value`(device)
`cell_count`()	Number of cells in the mesh.
`cell_deformation_gradient`(args, s)	Device function returning the transpose of the gradient of world position with respect to reference cell
`cell_inverse_deformation_gradient`(args, s)	Device function returning the matrix right-transforming a gradient w.r.t.
`cell_measure`(args, s)	Device function returning the measure determinant (e.g. volume, area) at a given point.
`cell_normal`(args, s)	Device function returning the element normal at a sample point.
`cell_position`(args, s)	Device function returning the world position of a cell sample point
`edge_count`()	Number of edges in the mesh.
`fill_cell_arg`(args, device)	Fill the arguments to be passed to cell-related device functions.
`fill_side_arg`(args, device)	Fill the arguments to be passed to side-related device functions.
`fill_side_index_arg`(args, device)	Fill the arguments to be passed to side-index device functions.
`make_filtered_cell_lookup`([filter_func])	Create a filtered cell lookup function.
`reference_cell`()	Reference element for mesh cells.
`reference_side`()	Reference element for mesh sides.
`side_arg_value`(device)
`side_count`()	Number of sides in the mesh.
`side_index_arg_value`(device)
`side_inner_inverse_deformation_gradient`(...)	Device function returning the matrix right-transforming a gradient w.r.t.
`side_measure`(args, s)	Device function returning the measure determinant (e.g. volume, area) at a given point.
`side_measure_ratio`(args, s)	Device function returning the ratio of the measure of a side to that of its neighbour cells
`side_normal`(args, s)	Device function returning the element normal at a sample point
`side_outer_inverse_deformation_gradient`(...)	Device function returning the matrix right-transforming a gradient w.r.t.
`supports_cell_lookup`(device)	Return whether cell lookups are supported on the given device.
`update_bvh`([device])	Refit the geometry's BVH if it exists on `device`, or build it from scratch otherwise.
`vertex_count`()	Number of vertices in the mesh.

Attributes

`CellArg`	Structure containing arguments to be passed to device functions evaluating cell-related quantities.
`SideArg`	Structure containing arguments to be passed to device functions evaluating side-related quantities.
`SideIndexArg`	Structure containing arguments to be passed to device functions for indexing sides.
`base`	Return the base geometry from which this geometry derives its topology.
`boundary_side_index`
`cell_bounds`
`cell_bvh_id`
`cell_dimension`	Manifold dimension of the geometry cells
`cell_lookup`	Device function for looking up the closest cell to a position.
`cell_measure_ratio`
`dimension`
`face_hex_indices`	Hex indices for each face.
`face_to_hex_coords`
`face_vertex_indices`	Vertex indices for each face.
`hex_edge_indices`	Edge indices for each hex element.
`name`	Name of the geometry.
`side_deformation_gradient`
`side_from_cell_coords`
`side_inner_cell_coords`
`side_inner_cell_index`
`side_outer_cell_coords`
`side_outer_cell_index`
`side_position`
`side_to_cell_arg`

dimension: int = 3#

cell_count()[source]#: Number of cells in the mesh.

vertex_count()[source]#: Number of vertices in the mesh.

side_count()[source]#: Number of sides in the mesh.

edge_count()[source]#: Number of edges in the mesh.

boundary_side_count()[source]#: Number of boundary sides in the mesh.

reference_cell()[source]#

Reference element for mesh cells.

Return type:: Element

reference_side()[source]#

Reference element for mesh sides.

Return type:: Element

property hex_edge_indices: array[source]#: Edge indices for each hex element.

property face_hex_indices: array[source]#: Hex indices for each face.

property face_vertex_indices: array[source]#: Vertex indices for each face.

CellArg: Struct = <warp._src.codegen.Struct object>#: Structure containing arguments to be passed to device functions evaluating cell-related quantities.

SideArg: Struct = <warp._src.codegen.Struct object>#: Structure containing arguments to be passed to device functions evaluating side-related quantities.

SideIndexArg: Struct = <warp._src.codegen.Struct object>#: Structure containing arguments to be passed to device functions for indexing sides.

fill_cell_arg(args, device)[source]#

Fill the arguments to be passed to cell-related device functions.

Parameters:: args (HexmeshCellArg)

fill_side_index_arg(args, device)[source]#

Fill the arguments to be passed to side-index device functions.

Parameters:: args (SideIndexArg)

boundary_side_index = <Function Hexmesh__boundary_side_index(args: warp._src.fem.geometry.hexmesh.Hexmesh.SideIndexArg, boundary_side_index: int)>#

Parameters:

args (SideIndexArg)
boundary_side_index (int)

fill_side_arg(args, device)[source]#

Fill the arguments to be passed to side-related device functions.

Parameters:: args (HexmeshSideArg)

side_position = <Function Hexmesh__side_position(args: warp._src.fem.geometry.hexmesh.HexmeshSideArg, s: warp._src.fem.types.Sample)>#

Parameters:

args (HexmeshSideArg)
s (Sample)

side_deformation_gradient = <Function Hexmesh__side_deformation_gradient(args: warp._src.fem.geometry.hexmesh.HexmeshSideArg, s: warp._src.fem.types.Sample)>#

Parameters:

args (HexmeshSideArg)
s (Sample)

side_inner_cell_index = <Function Hexmesh__side_inner_cell_index(arg: warp._src.fem.geometry.hexmesh.HexmeshSideArg, side_index: int)>#

Parameters:

arg (HexmeshSideArg)
side_index (int)

side_outer_cell_index = <Function Hexmesh__side_outer_cell_index(arg: warp._src.fem.geometry.hexmesh.HexmeshSideArg, side_index: int)>#

Parameters:

arg (HexmeshSideArg)
side_index (int)

face_to_hex_coords = <Function Hexmesh__face_to_hex_coords(local_face_index: int, face_orientation: int, side_coords: vec3f)>#

Parameters:

local_face_index (int)
face_orientation (int)
side_coords (vec3f)

side_inner_cell_coords = <Function Hexmesh__side_inner_cell_coords(args: warp._src.fem.geometry.hexmesh.HexmeshSideArg, side_index: int, side_coords: vec3f)>#

Parameters:

args (HexmeshSideArg)
side_index (int)
side_coords (vec3f)

side_outer_cell_coords = <Function Hexmesh__side_outer_cell_coords(args: warp._src.fem.geometry.hexmesh.HexmeshSideArg, side_index: int, side_coords: vec3f)>#

Parameters:

args (HexmeshSideArg)
side_index (int)
side_coords (vec3f)

side_from_cell_coords = <Function Hexmesh__side_from_cell_coords(args: warp._src.fem.geometry.hexmesh.HexmeshSideArg, side_index: int, hex_index: int, hex_coords: vec3f)>#

Parameters:

args (HexmeshSideArg)
side_index (int)
hex_index (int)
hex_coords (vec3f)

side_to_cell_arg = <Function Hexmesh__side_to_cell_arg(side_arg: warp._src.fem.geometry.hexmesh.HexmeshSideArg)>#

Parameters:: side_arg (HexmeshSideArg)

cell_bvh_id = <Function Hexmesh__cell_bvh_id(cell_arg: warp._src.fem.geometry.hexmesh.HexmeshCellArg)>#

Parameters:: cell_arg (HexmeshCellArg)

cell_bounds = <Function Hexmesh__cell_bounds(cell_arg: warp._src.fem.geometry.hexmesh.HexmeshCellArg, cell_index: int)>#

Parameters:

cell_arg (HexmeshCellArg)
cell_index (int)