fem.properties.sample_cell_property

fem.properties.sample_cell_property(sdf, points, cells, key, *, label='')

Sample one physical property per element, validated.

Parameters

Name	Type	Description	Default
sdf	Any	Scene SDF object answering material_at(p) -> dict.	required
points	Any	Node positions (N, 3) (may be traced).	required
cells	Any	Connectivity (C, ...).	required
key	str	Property name, e.g. "conductivity" or "youngs_modulus".	required
label	str	Optional context prefix for error messages (a study name).	''

Returns

Name	Type	Description
	Any	A JAX array of per-element values, (C,), differentiable in
	Any	points and in any free material parameter it reads.

Raises

Name	Type	Description
	ValueError	If the sampled field is NaN anywhere — i.e. some element sits in (or blends with) a material that does not specify the property. Concrete samples only; a traced sample cannot be inspected and is passed through.