![]() |
PyHelios 0.1.11
|
High-level interface for radiation modeling and ray tracing. More...
High-level interface for radiation modeling and ray tracing.
This class provides a user-friendly wrapper around the native Helios radiation plugin with automatic plugin availability checking and graceful error handling.
Definition at line 335 of file RadiationModel.py.
Public Member Functions | |
| __init__ (self, Context context) | |
| Initialize RadiationModel with graceful plugin handling. | |
| __enter__ (self) | |
| Context manager entry. | |
| __exit__ (self, exc_type, exc_value, traceback) | |
| Context manager exit with proper cleanup. | |
| __del__ (self) | |
| Destructor to ensure GPU resources freed even without 'with' statement. | |
| get_native_ptr (self) | |
| Get native pointer for advanced operations. | |
| getNativePtr (self) | |
| Get native pointer for advanced operations. | |
| disableMessages (self) | |
| Disable RadiationModel status messages. | |
| enableMessages (self) | |
| Enable RadiationModel status messages. | |
| addRadiationBand (self, str band_label, float wavelength_min=None, float wavelength_max=None) | |
| Add radiation band with optional wavelength bounds. | |
| copyRadiationBand (self, str old_label, str new_label, float wavelength_min=None, float wavelength_max=None) | |
| Copy existing radiation band to new label, optionally with new wavelength range. | |
| int | addCollimatedRadiationSource (self, direction=None) |
| Add collimated radiation source. | |
| int | addSphereRadiationSource (self, position, float radius) |
| Add spherical radiation source. | |
| int | addSunSphereRadiationSource (self, float radius, float zenith, float azimuth, float position_scaling=1.0, float angular_width=0.53, float flux_scaling=1.0) |
| Add sun sphere radiation source. | |
| setSourcePosition (self, int source_id, position) | |
| Set position of a radiation source. | |
| int | addRectangleRadiationSource (self, position, size, rotation) |
| Add a rectangle (planar) radiation source. | |
| int | addDiskRadiationSource (self, position, float radius, rotation) |
| Add a disk (circular planar) radiation source. | |
| setSourceSpectrum (self, source_id, spectrum) | |
| Set radiation spectrum for source(s). | |
| setSourceSpectrumIntegral (self, int source_id, float source_integral, float wavelength_min=None, float wavelength_max=None) | |
| Set source spectrum integral value. | |
| float | integrateSpectrum (self, object_spectrum, float wavelength_min=None, float wavelength_max=None, int source_id=None, camera_spectrum=None) |
| Integrate spectrum with optional source/camera spectra and wavelength range. | |
| float | integrateSourceSpectrum (self, int source_id, float wavelength_min, float wavelength_max) |
| Integrate source spectrum over wavelength range. | |
| scaleSpectrum (self, str existing_label, new_label_or_scale, float scale_factor=None) | |
| Scale spectrum in-place or to new label. | |
| scaleSpectrumRandomly (self, str existing_label, str new_label, float min_scale, float max_scale) | |
| Scale spectrum with random factor and store as new label. | |
| blendSpectra (self, str new_label, List[str] spectrum_labels, List[float] weights) | |
| Blend multiple spectra with specified weights. | |
| blendSpectraRandomly (self, str new_label, List[str] spectrum_labels) | |
| Blend multiple spectra with random weights. | |
| interpolateSpectrumFromPrimitiveData (self, List[int] primitive_uuids, List[str] spectra_labels, List[float] values, str primitive_data_query_label, str primitive_data_radprop_label) | |
| Interpolate spectral properties based on primitive data values. | |
| interpolateSpectrumFromObjectData (self, List[int] object_ids, List[str] spectra_labels, List[float] values, str object_data_query_label, str primitive_data_radprop_label) | |
| Interpolate spectral properties based on object data values. | |
| setDirectRayCount (self, str band_label, int ray_count) | |
| Set direct ray count for radiation band. | |
| setDiffuseRayCount (self, str band_label, int ray_count) | |
| Set diffuse ray count for radiation band. | |
| setDiffuseRadiationFlux (self, str label, float flux) | |
| Set diffuse radiation flux for band. | |
| setDiffuseRadiationExtinctionCoeff (self, str label, float K, peak_direction) | |
| Set diffuse radiation extinction coefficient with directional bias. | |
| float | getDiffuseFlux (self, str band_label) |
| Get diffuse flux for band. | |
| setDiffuseSpectrum (self, band_label, str spectrum_label) | |
| Set diffuse spectrum from global data label. | |
| setDiffuseSpectrumIntegral (self, float spectrum_integral, float wavelength_min=None, float wavelength_max=None, str band_label=None) | |
| Set diffuse spectrum integral. | |
| setSourceFlux (self, source_id, str label, float flux) | |
| Set source flux for single source or multiple sources. | |
| float | getSourceFlux (self, int source_id, str label) |
| Get source flux for band. | |
| updateGeometry (self, Optional[List[int]] uuids=None) | |
| Update geometry in radiation model. | |
| runBand (self, band_label) | |
| Run radiation simulation for single band or multiple bands. | |
| List[float] | getTotalAbsorbedFlux (self) |
| Get total absorbed flux for all primitives. | |
| bool | doesBandExist (self, str label) |
| Check if a radiation band exists. | |
| deleteRadiationSource (self, int source_id) | |
| Delete a radiation source. | |
| getSourcePosition (self, int source_id) | |
| Get position of a radiation source. | |
| float | getSkyEnergy (self) |
| Get total sky energy. | |
| float | calculateGtheta (self, view_direction) |
| Calculate G-function (geometry factor) for given view direction. | |
| optionalOutputPrimitiveData (self, str label) | |
| Enable optional primitive data output. | |
| enforcePeriodicBoundary (self, str boundary) | |
| Enforce periodic boundary conditions. | |
| setScatteringDepth (self, str label, int depth) | |
| Set scattering depth for radiation band. | |
| setMinScatterEnergy (self, str label, float energy) | |
| Set minimum scatter energy for radiation band. | |
| disableEmission (self, str label) | |
| Disable emission for radiation band. | |
| enableEmission (self, str label) | |
| Enable emission for radiation band. | |
| addRadiationCamera (self, str camera_label, List[str] band_labels, position, lookat_or_direction, camera_properties=None, int antialiasing_samples=100) | |
| Add a radiation camera to the simulation. | |
| setCameraPosition (self, str camera_label, position) | |
| Set camera position. | |
| getCameraPosition (self, str camera_label) | |
| Get camera position. | |
| setCameraLookat (self, str camera_label, lookat) | |
| Set camera lookat point. | |
| getCameraLookat (self, str camera_label) | |
| Get camera lookat point. | |
| setCameraOrientation (self, str camera_label, direction) | |
| Set camera orientation. | |
| getCameraOrientation (self, str camera_label) | |
| Get camera orientation. | |
| List[str] | getAllCameraLabels (self) |
| Get all camera labels. | |
| setCameraSpectralResponse (self, str camera_label, str band_label, str global_data) | |
| Set camera spectral response from global data. | |
| setCameraSpectralResponseFromLibrary (self, str camera_label, str camera_library_name) | |
| Set camera spectral response from standard camera library. | |
| List[float] | getCameraPixelData (self, str camera_label, str band_label) |
| Get camera pixel data for specific band. | |
| setCameraPixelData (self, str camera_label, str band_label, List[float] pixel_data) | |
| Set camera pixel data for specific band. | |
| addRadiationCameraFromLibrary (self, str camera_label, str library_camera_label, position, lookat, int antialiasing_samples=1, Optional[List[str]] band_labels=None) | |
| Add radiation camera loading all properties from camera library. | |
| updateCameraParameters (self, str camera_label, CameraProperties camera_properties) | |
| Update camera parameters for an existing camera. | |
| enableCameraMetadata (self, camera_labels) | |
| Enable automatic JSON metadata file writing for camera(s). | |
| str | writeCameraImage (self, str camera, List[str] bands, str imagefile_base, str image_path="./", int frame=-1, float flux_to_pixel_conversion=1.0) |
| Write camera image to file and return output filename. | |
| str | writeNormCameraImage (self, str camera, List[str] bands, str imagefile_base, str image_path="./", int frame=-1) |
| Write normalized camera image to file and return output filename. | |
| writeCameraImageData (self, str camera, str band, str imagefile_base, str image_path="./", int frame=-1) | |
| Write camera image data to file (ASCII format). | |
| writeImageBoundingBoxes (self, str camera_label, primitive_data_labels=None, object_data_labels=None, object_class_ids=None, str image_file="", str classes_txt_file="classes.txt", str image_path="./") | |
| Write image bounding boxes for object detection training. | |
| writeImageSegmentationMasks (self, str camera_label, primitive_data_labels=None, object_data_labels=None, object_class_ids=None, str json_filename="", str image_file="", bool append_file=False) | |
| Write image segmentation masks in COCO JSON format. | |
| str | autoCalibrateCameraImage (self, str camera_label, str red_band_label, str green_band_label, str blue_band_label, str output_file_path, bool print_quality_report=False, str algorithm="MATRIX_3X3_AUTO", str ccm_export_file_path="") |
| Auto-calibrate camera image with color correction and return output filename. | |
| dict | getPluginInfo (self) |
| Get information about the radiation plugin. | |
Public Attributes | |
| context = context | |
| radiation_model = None | |
| pyhelios.RadiationModel.RadiationModel.__init__ | ( | self, | |
| Context | context ) |
Initialize RadiationModel with graceful plugin handling.
| context | Helios Context instance |
| TypeError | If context is not a Context instance |
| RadiationModelError | If radiation plugin is not available |
Definition at line 347 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.__del__ | ( | self | ) |
Destructor to ensure GPU resources freed even without 'with' statement.
Definition at line 416 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.__enter__ | ( | self | ) |
Context manager entry.
Definition at line 401 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.__exit__ | ( | self, | |
| exc_type, | |||
| exc_value, | |||
| traceback ) |
Context manager exit with proper cleanup.
Definition at line 405 of file RadiationModel.py.
| int pyhelios.RadiationModel.RadiationModel.addCollimatedRadiationSource | ( | self, | |
| direction = None ) |
Add collimated radiation source.
| direction | Optional direction vector. Can be tuple (x, y, z), vec3, or None for default direction. |
Definition at line 502 of file RadiationModel.py.
| int pyhelios.RadiationModel.RadiationModel.addDiskRadiationSource | ( | self, | |
| position, | |||
| float | radius, | ||
| rotation ) |
Add a disk (circular planar) radiation source.
Disk sources are useful for modeling circular light sources such as spotlights, circular LED arrays, or solar simulators.
| position | Center position as vec3 or list [x, y, z] |
| radius | Disk radius |
| rotation | Rotation vector as vec3 or list [rx, ry, rz] (Euler angles in radians) |
Definition at line 656 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.addRadiationBand | ( | self, | |
| str | band_label, | ||
| float | wavelength_min = None, | ||
| float | wavelength_max = None ) |
Add radiation band with optional wavelength bounds.
| band_label | Name/label for the radiation band |
| wavelength_min | Optional minimum wavelength (μm) |
| wavelength_max | Optional maximum wavelength (μm) |
Definition at line 452 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.addRadiationCamera | ( | self, | |
| str | camera_label, | ||
| List[str] | band_labels, | ||
| position, | |||
| lookat_or_direction, | |||
| camera_properties = None, | |||
| int | antialiasing_samples = 100 ) |
Add a radiation camera to the simulation.
| camera_label | Unique label string for the camera |
| band_labels | List of radiation band labels for the camera |
| position | Camera position as vec3 object |
| lookat_or_direction | Either:
|
| camera_properties | CameraProperties instance or None for defaults |
| antialiasing_samples | Number of antialiasing samples (default: 100) |
| ValidationError | If parameters are invalid or have wrong types |
| RadiationModelError | If camera creation fails |
Definition at line 1383 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.addRadiationCameraFromLibrary | ( | self, | |
| str | camera_label, | ||
| str | library_camera_label, | ||
| position, | |||
| lookat, | |||
| int | antialiasing_samples = 1, | ||
| Optional[List[str]] | band_labels = None ) |
Add radiation camera loading all properties from camera library.
Loads camera intrinsic parameters (resolution, FOV, sensor size) and spectral response data from the camera library XML file. This is the recommended way to create realistic cameras with proper spectral responses.
| camera_label | Label for the camera instance |
| library_camera_label | Label of camera in library (e.g., "Canon_20D", "iPhone11", "NikonD700") |
| position | Camera position as vec3 or (x, y, z) tuple |
| lookat | Lookat point as vec3 or (x, y, z) tuple |
| antialiasing_samples | Number of ray samples per pixel. Default: 1 |
| band_labels | Optional custom band labels. If None, uses library defaults. |
| RadiationModelError | If operation fails |
| ValueError | If parameters are invalid |
Definition at line 1715 of file RadiationModel.py.
| int pyhelios.RadiationModel.RadiationModel.addRectangleRadiationSource | ( | self, | |
| position, | |||
| size, | |||
| rotation ) |
Add a rectangle (planar) radiation source.
Rectangle sources are ideal for modeling artificial lighting such as LED panels, grow lights, or window light sources.
| position | Center position as vec3 or list [x, y, z] |
| size | Rectangle dimensions as vec2 or list [width, height] |
| rotation | Rotation vector as vec3 or list [rx, ry, rz] (Euler angles in radians) |
Definition at line 629 of file RadiationModel.py.
| int pyhelios.RadiationModel.RadiationModel.addSphereRadiationSource | ( | self, | |
| position, | |||
| float | radius ) |
Add spherical radiation source.
| position | Position of the source. Can be tuple (x, y, z) or vec3. |
| radius | Radius of the spherical source |
Definition at line 545 of file RadiationModel.py.
| int pyhelios.RadiationModel.RadiationModel.addSunSphereRadiationSource | ( | self, | |
| float | radius, | ||
| float | zenith, | ||
| float | azimuth, | ||
| float | position_scaling = 1.0, | ||
| float | angular_width = 0.53, | ||
| float | flux_scaling = 1.0 ) |
Add sun sphere radiation source.
| radius | Radius of the sun sphere |
| zenith | Zenith angle (degrees) |
| azimuth | Azimuth angle (degrees) |
| position_scaling | Position scaling factor |
| angular_width | Angular width of the sun (degrees) |
| flux_scaling | Flux scaling factor |
Definition at line 573 of file RadiationModel.py.
| str pyhelios.RadiationModel.RadiationModel.autoCalibrateCameraImage | ( | self, | |
| str | camera_label, | ||
| str | red_band_label, | ||
| str | green_band_label, | ||
| str | blue_band_label, | ||
| str | output_file_path, | ||
| bool | print_quality_report = False, | ||
| str | algorithm = "MATRIX_3X3_AUTO", | ||
| str | ccm_export_file_path = "" ) |
Auto-calibrate camera image with color correction and return output filename.
| camera_label | Camera label |
| red_band_label | Red band label |
| green_band_label | Green band label |
| blue_band_label | Blue band label |
| output_file_path | Output file path |
| print_quality_report | Whether to print quality report |
| algorithm | Color correction algorithm ("DIAGONAL_ONLY", "MATRIX_3X3_AUTO", "MATRIX_3X3_FORCE") |
| ccm_export_file_path | Path to export color correction matrix (optional) |
| RadiationModelError | If auto-calibration fails |
| TypeError | If parameters have incorrect types |
| ValueError | If algorithm is not valid |
Definition at line 2146 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.blendSpectra | ( | self, | |
| str | new_label, | ||
| List[str] | spectrum_labels, | ||
| List[float] | weights ) |
Blend multiple spectra with specified weights.
Creates weighted combination of spectra, useful for mixing material properties or creating composite light sources.
| new_label | New global data label for blended spectrum |
| spectrum_labels | List of spectrum labels to blend |
| weights | List of weights (must sum to reasonable values, same length as labels) |
Definition at line 872 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.blendSpectraRandomly | ( | self, | |
| str | new_label, | ||
| List[str] | spectrum_labels ) |
Blend multiple spectra with random weights.
Creates random combinations of spectra, useful for generating diverse material properties in stochastic simulations.
| new_label | New global data label for blended spectrum |
| spectrum_labels | List of spectrum labels to blend |
Definition at line 900 of file RadiationModel.py.
| float pyhelios.RadiationModel.RadiationModel.calculateGtheta | ( | self, | |
| view_direction ) |
Calculate G-function (geometry factor) for given view direction.
The G-function describes the geometric relationship between leaf area distribution and viewing direction, important for canopy radiation modeling.
| view_direction | View direction as vec3 or list/tuple [x, y, z] |
Definition at line 1290 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.copyRadiationBand | ( | self, | |
| str | old_label, | ||
| str | new_label, | ||
| float | wavelength_min = None, | ||
| float | wavelength_max = None ) |
Copy existing radiation band to new label, optionally with new wavelength range.
| old_label | Existing band label to copy |
| new_label | New label for the copied band |
| wavelength_min | Optional minimum wavelength for new band (μm) |
| wavelength_max | Optional maximum wavelength for new band (μm) |
Definition at line 481 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.deleteRadiationSource | ( | self, | |
| int | source_id ) |
Delete a radiation source.
| source_id | ID of the radiation source to delete |
Definition at line 1229 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.disableEmission | ( | self, | |
| str | label ) |
Disable emission for radiation band.
Definition at line 1343 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.disableMessages | ( | self | ) |
Disable RadiationModel status messages.
Definition at line 435 of file RadiationModel.py.
| bool pyhelios.RadiationModel.RadiationModel.doesBandExist | ( | self, | |
| str | label ) |
Check if a radiation band exists.
| label | Name/label of the radiation band to check |
Definition at line 1213 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.enableCameraMetadata | ( | self, | |
| camera_labels ) |
Enable automatic JSON metadata file writing for camera(s).
When enabled, writeCameraImage() automatically creates a JSON metadata file alongside the image containing comprehensive camera and scene information.
| camera_labels | Single camera label (str) or list of camera labels (List[str]) |
| RadiationModelError | If operation fails |
| ValueError | If parameters are invalid |
Definition at line 1796 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.enableEmission | ( | self, | |
| str | label ) |
Enable emission for radiation band.
Definition at line 1349 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.enableMessages | ( | self | ) |
Enable RadiationModel status messages.
Definition at line 440 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.enforcePeriodicBoundary | ( | self, | |
| str | boundary ) |
Enforce periodic boundary conditions.
Periodic boundaries are useful for large-scale simulations to reduce edge effects by wrapping radiation at domain boundaries.
| boundary | Boundary specification string (e.g., "xy", "xyz", "x", "y", "z") |
Definition at line 1322 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.get_native_ptr | ( | self | ) |
Get native pointer for advanced operations.
Definition at line 426 of file RadiationModel.py.
| List[str] pyhelios.RadiationModel.RadiationModel.getAllCameraLabels | ( | self | ) |
Get all camera labels.
Definition at line 1579 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.getCameraLookat | ( | self, | |
| str | camera_label ) |
Get camera lookat point.
| camera_label | Camera label string |
Definition at line 1521 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.getCameraOrientation | ( | self, | |
| str | camera_label ) |
Get camera orientation.
| camera_label | Camera label string |
Definition at line 1561 of file RadiationModel.py.
| List[float] pyhelios.RadiationModel.RadiationModel.getCameraPixelData | ( | self, | |
| str | camera_label, | ||
| str | band_label ) |
Get camera pixel data for specific band.
Retrieves raw pixel values for programmatic access and analysis.
| camera_label | Camera label |
| band_label | Band label |
Definition at line 1643 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.getCameraPosition | ( | self, | |
| str | camera_label ) |
Get camera position.
| camera_label | Camera label string |
Definition at line 1483 of file RadiationModel.py.
| float pyhelios.RadiationModel.RadiationModel.getDiffuseFlux | ( | self, | |
| str | band_label ) |
Get diffuse flux for band.
| band_label | Band label |
Definition at line 1054 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.getNativePtr | ( | self | ) |
Get native pointer for advanced operations.
(Legacy naming for compatibility)
Definition at line 430 of file RadiationModel.py.
| dict pyhelios.RadiationModel.RadiationModel.getPluginInfo | ( | self | ) |
Get information about the radiation plugin.
Definition at line 2188 of file RadiationModel.py.
| float pyhelios.RadiationModel.RadiationModel.getSkyEnergy | ( | self | ) |
Get total sky energy.
Definition at line 1269 of file RadiationModel.py.
| float pyhelios.RadiationModel.RadiationModel.getSourceFlux | ( | self, | |
| int | source_id, | ||
| str | label ) |
Get source flux for band.
Definition at line 1126 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.getSourcePosition | ( | self, | |
| int | source_id ) |
Get position of a radiation source.
| source_id | ID of the radiation source |
Definition at line 1250 of file RadiationModel.py.
| List[float] pyhelios.RadiationModel.RadiationModel.getTotalAbsorbedFlux | ( | self | ) |
Get total absorbed flux for all primitives.
Definition at line 1190 of file RadiationModel.py.
| float pyhelios.RadiationModel.RadiationModel.integrateSourceSpectrum | ( | self, | |
| int | source_id, | ||
| float | wavelength_min, | ||
| float | wavelength_max ) |
Integrate source spectrum over wavelength range.
| source_id | Source ID |
| wavelength_min | Minimum wavelength |
| wavelength_max | Maximum wavelength |
Definition at line 785 of file RadiationModel.py.
| float pyhelios.RadiationModel.RadiationModel.integrateSpectrum | ( | self, | |
| object_spectrum, | |||
| float | wavelength_min = None, | ||
| float | wavelength_max = None, | ||
| int | source_id = None, | ||
| camera_spectrum = None ) |
Integrate spectrum with optional source/camera spectra and wavelength range.
This unified method handles multiple integration scenarios: - Basic: Total spectrum integration - Range: Integration over wavelength range - Source: Integration weighted by source spectrum - Camera: Integration weighted by camera spectral response - Full: Integration with both source and camera spectra
| object_spectrum | Object spectrum as list of (wavelength, value) tuples/vec2 |
| wavelength_min | Optional minimum wavelength for integration range |
| wavelength_max | Optional maximum wavelength for integration range |
| source_id | Optional source ID for source spectrum weighting |
| camera_spectrum | Optional camera spectrum for camera response weighting |
Definition at line 763 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.interpolateSpectrumFromObjectData | ( | self, | |
| List[int] | object_ids, | ||
| List[str] | spectra_labels, | ||
| List[float] | values, | ||
| str | object_data_query_label, | ||
| str | primitive_data_radprop_label ) |
Interpolate spectral properties based on object data values.
Automatically assigns spectra to object primitives by interpolating between reference spectra based on continuous object-level data values.
| object_ids | List of object IDs |
| spectra_labels | List of reference spectrum labels |
| values | List of data values corresponding to each spectrum |
| object_data_query_label | Object data label containing query values |
| primitive_data_radprop_label | Primitive data label to store assigned spectra |
Definition at line 979 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.interpolateSpectrumFromPrimitiveData | ( | self, | |
| List[int] | primitive_uuids, | ||
| List[str] | spectra_labels, | ||
| List[float] | values, | ||
| str | primitive_data_query_label, | ||
| str | primitive_data_radprop_label ) |
Interpolate spectral properties based on primitive data values.
Automatically assigns spectra to primitives by interpolating between reference spectra based on continuous data values (e.g., age, moisture, etc.).
| primitive_uuids | List of primitive UUIDs to assign spectra |
| spectra_labels | List of reference spectrum labels |
| values | List of data values corresponding to each spectrum |
| primitive_data_query_label | Primitive data label containing query values |
| primitive_data_radprop_label | Primitive data label to store assigned spectra |
Definition at line 935 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.optionalOutputPrimitiveData | ( | self, | |
| str | label ) |
Enable optional primitive data output.
| label | Name/label of the primitive data to output |
Definition at line 1304 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.runBand | ( | self, | |
| band_label ) |
Run radiation simulation for single band or multiple bands.
PERFORMANCE When simulating multiple radiation bands, it is HIGHLY RECOMMENDED to run all bands in a single call (e.g., runBand(["PAR", "NIR", "SW"])) rather than sequential single-band calls. This provides significant computational efficiency gains because: - GPU ray tracing setup is done once for all bands - Scene geometry acceleration structures are reused - OptiX kernel launches are batched together - Memory transfers between CPU/GPU are minimized
radiation.runBand(["PAR", "NIR", "SW"])
radiation.runBand("PAR") radiation.runBand("NIR") radiation.runBand("SW")
| band_label | Single band name (str) or list of band names for multi-band simulation |
Definition at line 1172 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.scaleSpectrum | ( | self, | |
| str | existing_label, | ||
| new_label_or_scale, | |||
| float | scale_factor = None ) |
Scale spectrum in-place or to new label.
Useful for adjusting spectrum intensities or creating variations of
existing spectra for sensitivity analysis.
Supports two call patterns:
- scaleSpectrum("label", scale) -> scales in-place
- scaleSpectrum("existing", "new", scale) -> creates new scaled spectrum
| existing_label | Existing global data label |
| new_label_or_scale | Either new label string (if creating new) or scale factor (if in-place) |
| scale_factor | Scale factor (required only if new_label_or_scale is a string) |
Definition at line 815 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.scaleSpectrumRandomly | ( | self, | |
| str | existing_label, | ||
| str | new_label, | ||
| float | min_scale, | ||
| float | max_scale ) |
Scale spectrum with random factor and store as new label.
Useful for creating stochastic variations in spectral properties for Monte Carlo simulations or uncertainty quantification.
| existing_label | Existing global data label |
| new_label | New global data label for scaled spectrum |
| min_scale | Minimum scale factor |
| max_scale | Maximum scale factor |
Definition at line 840 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.setCameraLookat | ( | self, | |
| str | camera_label, | ||
| lookat ) |
Set camera lookat point.
| camera_label | Camera label string |
| lookat | Lookat point as vec3 or list [x, y, z] |
Definition at line 1501 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.setCameraOrientation | ( | self, | |
| str | camera_label, | ||
| direction ) |
Set camera orientation.
| camera_label | Camera label string |
| direction | View direction as vec3, SphericalCoord, or list [x, y, z] |
Definition at line 1541 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.setCameraPixelData | ( | self, | |
| str | camera_label, | ||
| str | band_label, | ||
| List[float] | pixel_data ) |
Set camera pixel data for specific band.
Allows programmatic modification of pixel values.
| camera_label | Camera label |
| band_label | Band label |
| pixel_data | List of pixel values |
Definition at line 1666 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.setCameraPosition | ( | self, | |
| str | camera_label, | ||
| position ) |
Set camera position.
Allows dynamic camera repositioning during simulation, useful for time-series captures or multi-view imaging.
| camera_label | Camera label string |
| position | Camera position as vec3 or list [x, y, z] |
Definition at line 1463 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.setCameraSpectralResponse | ( | self, | |
| str | camera_label, | ||
| str | band_label, | ||
| str | global_data ) |
Set camera spectral response from global data.
| camera_label | Camera label |
| band_label | Band label |
| global_data | Global data label for spectral response curve |
Definition at line 1594 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.setCameraSpectralResponseFromLibrary | ( | self, | |
| str | camera_label, | ||
| str | camera_library_name ) |
Set camera spectral response from standard camera library.
Uses pre-defined spectral response curves for common cameras.
| camera_label | Camera label |
| camera_library_name | Standard camera name (e.g., "iPhone13", "NikonD850", "CanonEOS5D") |
Definition at line 1617 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.setDiffuseRadiationExtinctionCoeff | ( | self, | |
| str | label, | ||
| float | K, | ||
| peak_direction ) |
Set diffuse radiation extinction coefficient with directional bias.
Models directionally-biased diffuse radiation (e.g., sky radiation with zenith peak).
| label | Band label |
| K | Extinction coefficient |
| peak_direction | Peak direction as vec3, SphericalCoord, or list [x, y, z] |
Definition at line 1034 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.setDiffuseRadiationFlux | ( | self, | |
| str | label, | ||
| float | flux ) |
Set diffuse radiation flux for band.
Definition at line 1014 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.setDiffuseRayCount | ( | self, | |
| str | band_label, | ||
| int | ray_count ) |
Set diffuse ray count for radiation band.
Definition at line 1007 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.setDiffuseSpectrum | ( | self, | |
| band_label, | |||
| str | spectrum_label ) |
Set diffuse spectrum from global data label.
| band_label | Band label (string) or list of band labels |
| spectrum_label | Spectrum global data label |
Definition at line 1070 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.setDiffuseSpectrumIntegral | ( | self, | |
| float | spectrum_integral, | ||
| float | wavelength_min = None, | ||
| float | wavelength_max = None, | ||
| str | band_label = None ) |
Set diffuse spectrum integral.
| spectrum_integral | Integral value |
| wavelength_min | Optional minimum wavelength |
| wavelength_max | Optional maximum wavelength |
| band_label | Optional specific band label (None for all bands) |
Definition at line 1096 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.setDirectRayCount | ( | self, | |
| str | band_label, | ||
| int | ray_count ) |
Set direct ray count for radiation band.
Definition at line 1000 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.setMinScatterEnergy | ( | self, | |
| str | label, | ||
| float | energy ) |
Set minimum scatter energy for radiation band.
Definition at line 1338 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.setScatteringDepth | ( | self, | |
| str | label, | ||
| int | depth ) |
Set scattering depth for radiation band.
Definition at line 1332 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.setSourceFlux | ( | self, | |
| source_id, | |||
| str | label, | ||
| float | flux ) |
Set source flux for single source or multiple sources.
Definition at line 1109 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.setSourcePosition | ( | self, | |
| int | source_id, | ||
| position ) |
Set position of a radiation source.
Allows dynamic repositioning of radiation sources during simulation, useful for time-series modeling or moving light sources.
| source_id | ID of the radiation source |
| position | New position as vec3, SphericalCoord, or list/tuple [x, y, z] |
Definition at line 599 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.setSourceSpectrum | ( | self, | |
| source_id, | |||
| spectrum ) |
Set radiation spectrum for source(s).
Spectral distributions define how radiation intensity varies with wavelength, essential for realistic modeling of different light sources (sunlight, LEDs, etc.).
| source_id | Source ID (int) or list of source IDs |
| spectrum | Either:
|
Definition at line 689 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.setSourceSpectrumIntegral | ( | self, | |
| int | source_id, | ||
| float | source_integral, | ||
| float | wavelength_min = None, | ||
| float | wavelength_max = None ) |
Set source spectrum integral value.
Normalizes the spectrum so that its integral equals the specified value, useful for calibrating source intensity.
| source_id | Source ID |
| source_integral | Target integral value |
| wavelength_min | Optional minimum wavelength for integration range |
| wavelength_max | Optional maximum wavelength for integration range |
Definition at line 710 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.updateCameraParameters | ( | self, | |
| str | camera_label, | ||
| CameraProperties | camera_properties ) |
Update camera parameters for an existing camera.
Allows modification of camera properties after creation while preserving position, lookat direction, and spectral band configuration.
| camera_label | Label for the camera to update |
| camera_properties | CameraProperties instance with new parameters |
| RadiationModelError | If operation fails or camera doesn't exist |
| ValueError | If parameters are invalid |
Definition at line 1756 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.updateGeometry | ( | self, | |
| Optional[List[int]] | uuids = None ) |
Update geometry in radiation model.
| uuids | Optional list of specific UUIDs to update. If None, updates all geometry. |
Definition at line 1137 of file RadiationModel.py.
| str pyhelios.RadiationModel.RadiationModel.writeCameraImage | ( | self, | |
| str | camera, | ||
| List[str] | bands, | ||
| str | imagefile_base, | ||
| str | image_path = "./", | ||
| int | frame = -1, | ||
| float | flux_to_pixel_conversion = 1.0 ) |
Write camera image to file and return output filename.
| camera | Camera label |
| bands | List of band labels to include in the image |
| imagefile_base | Base filename for output |
| image_path | Output directory path (default: current directory) |
| frame | Frame number to write (-1 for all frames) |
| flux_to_pixel_conversion | Conversion factor from flux to pixel values |
| RadiationModelError | If camera image writing fails |
| TypeError | If parameters have incorrect types |
Definition at line 1825 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.writeCameraImageData | ( | self, | |
| str | camera, | ||
| str | band, | ||
| str | imagefile_base, | ||
| str | image_path = "./", | ||
| int | frame = -1 ) |
Write camera image data to file (ASCII format).
| camera | Camera label |
| band | Band label |
| imagefile_base | Base filename for output |
| image_path | Output directory path (default: current directory) |
| frame | Frame number to write (-1 for all frames) |
| RadiationModelError | If camera image data writing fails |
| TypeError | If parameters have incorrect types |
Definition at line 1906 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.writeImageBoundingBoxes | ( | self, | |
| str | camera_label, | ||
| primitive_data_labels = None, | |||
| object_data_labels = None, | |||
| object_class_ids = None, | |||
| str | image_file = "", | ||
| str | classes_txt_file = "classes.txt", | ||
| str | image_path = "./" ) |
Write image bounding boxes for object detection training.
Supports both single and multiple data labels. Either provide primitive_data_labels or object_data_labels, not both.
| camera_label | Camera label |
| primitive_data_labels | Single primitive data label (str) or list of primitive data labels |
| object_data_labels | Single object data label (str) or list of object data labels |
| object_class_ids | Single class ID (int) or list of class IDs (must match data labels) |
| image_file | Image filename |
| classes_txt_file | Classes definition file (default: "classes.txt") |
| image_path | Image output path (default: current directory) |
| RadiationModelError | If bounding box writing fails |
| TypeError | If parameters have incorrect types |
| ValueError | If both primitive and object data labels are provided, or neither |
Definition at line 1946 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.writeImageSegmentationMasks | ( | self, | |
| str | camera_label, | ||
| primitive_data_labels = None, | |||
| object_data_labels = None, | |||
| object_class_ids = None, | |||
| str | json_filename = "", | ||
| str | image_file = "", | ||
| bool | append_file = False ) |
Write image segmentation masks in COCO JSON format.
Supports both single and multiple data labels. Either provide primitive_data_labels or object_data_labels, not both.
| camera_label | Camera label |
| primitive_data_labels | Single primitive data label (str) or list of primitive data labels |
| object_data_labels | Single object data label (str) or list of object data labels |
| object_class_ids | Single class ID (int) or list of class IDs (must match data labels) |
| json_filename | JSON output filename |
| image_file | Image filename |
| append_file | Whether to append to existing JSON file |
| RadiationModelError | If segmentation mask writing fails |
| TypeError | If parameters have incorrect types |
| ValueError | If both primitive and object data labels are provided, or neither |
Definition at line 2046 of file RadiationModel.py.
| str pyhelios.RadiationModel.RadiationModel.writeNormCameraImage | ( | self, | |
| str | camera, | ||
| List[str] | bands, | ||
| str | imagefile_base, | ||
| str | image_path = "./", | ||
| int | frame = -1 ) |
Write normalized camera image to file and return output filename.
| camera | Camera label |
| bands | List of band labels to include in the image |
| imagefile_base | Base filename for output |
| image_path | Output directory path (default: current directory) |
| frame | Frame number to write (-1 for all frames) |
| RadiationModelError | If normalized camera image writing fails |
| TypeError | If parameters have incorrect types |
Definition at line 1869 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.context = context |
Definition at line 352 of file RadiationModel.py.
| pyhelios.RadiationModel.RadiationModel.radiation_model = None |
Definition at line 353 of file RadiationModel.py.