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).	`''`

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

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.