particula.optics.gpu.bulk
Prepared bounded-memory optical reductions across particle populations.
Classes
| Name | Description |
|---|---|
PopulationWorkspace | Retained streaming population outputs, commands and scratch. |
Functions
| Name | Description |
|---|---|
prepare_population_mie | Prepare streamed bulk optics without retaining particle optical output. |
PopulationWorkspaceclassdataclass#
class PopulationWorkspace(optics: wp.array, mueller: wp.array, status: wp.array, particle_tile: int, _commands: tuple, _resources: tuple, _device: str, _stream: wp.Stream | None)Retained streaming population outputs, commands and scratch.
Attributes
| Name | Type | Description |
|---|---|---|
optics | wp.array | (groups,9): extinction, scattering, absorption, backscatter, radiation pressure [m⁻¹], SSA, g, extinction/scattering validity. |
mueller | wp.array | (groups,angles,4,4) differential matrices [m⁻¹/sr]; zero length angle axis when angular output was not requested. |
status | wp.array | Per-group status; 0 success, 2 input/upstream error, 3 overflow. |
particle_tile | int | Fixed maximum live particle scratch count. |
Groups flatten box/wavelength axes. Outputs require enqueue and successful observation; inputs may be updated in place on the prepared stream.
_commandsattributeinstance attribute#
_commands: tuple_deviceattributeinstance attribute#
_device: str_resourcesattributeinstance attribute#
_resources: tuple_streamattributeinstance attribute#
_stream: wp.Stream | Nonemuellerattributeinstance attribute#
mueller: wp.arrayopticsattributeinstance attribute#
optics: wp.arrayparticle_tileattributeinstance attribute#
particle_tile: intstatusattributeinstance attribute#
status: wp.array__init__method#
def __init__(optics: wp.array, mueller: wp.array, status: wp.array, particle_tile: int, _commands: tuple, _resources: tuple, _device: str, _stream: wp.Stream | None) -> Nonecheckmethod#
def check() -> NoneExplicitly synchronize and reject failed population results.
enqueuemethod#
def enqueue() -> NoneEnqueue the retained streaming calculation without host transfers.
prepare_population_miefunction#
def prepare_population_mie(relative_index: wp.array, size_parameter: wp.array, radius: wp.array, number_density_weights: wp.array, *, angles: wp.array | None = None, particle_tile: int = 256, angle_tile: int = 128, coefficient_capacity: int = 10090, stream=None) -> PopulationWorkspacePrepare streamed bulk optics without retaining particle optical output.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
relative_index | wp.array | required | Contiguous (groups,particles) vec2d relative n+ik. |
size_parameter | wp.array | required | Same shape float64 x=2pir*n_medium/lambda_vacuum. |
radius | wp.array | required | Same shape float64 SI radius [m], consistent with x. |
number_density_weights | wp.array | required | Same shape float64 density weights [m⁻³]. Callers supply discrete, resolved-count/volume or PDF weights. |
angles | wp.array | None | None | Optional shared 1D float64 angles [rad], on the same device. |
particle_tile | int | 256 | Maximum particles in scratch, default 256. |
angle_tile | int | 128 | Angular launch width, default 128. |
coefficient_capacity | int | 10090 | Maximum retained series order, default 10090. |
stream | None | Optional matching CUDA stream; used for all work and checks. |
Returns
PopulationWorkspace- Population workspace. Scratch is bounded by particle_tile, series
PopulationWorkspace- capacity and angle count, independently of total particle count.
PopulationWorkspace- No CPU transfers, fallback or scientific launches during preparation.
Raises
ValueError- If shapes/devices/capacities conflict. Physical-value errors are reported by check after enqueue, without host input readback.