 |
0.1.26
|
|
0.1.26
|
RadiationModel, EnergyBalanceModel, PhotosynthesisModel, StomatalConductanceModel, BoundaryLayerConductanceModel, LeafOptics, SolarPosition, PlantArchitecture, WeberPennTree, Visualizer, and LiDARCloud's collision detection) passes the raw native Context* to a C++ constructor that stores it for the model's lifetime. Destroying the Context first — by leaving its with block, or by letting a temporary Context (e.g. visualizer.buildContextGeometry(make_scene())) be garbage collected — freed that memory while the model still held the pointer, so the next call segfaulted the interpreter. Models now retain a Python reference to the owning Context and check liveness before every native call, raising an actionable RuntimeError instead of crashing. LiDARCloud additionally rejects enableCollisionDetection() with a second, different Context, which the native side silently ignored (it keeps whichever Context it was first given).vec4 satisfied a vec3 attribute check and reached C++ as a wrong-length buffer (to_list() returns 4 elements), and an RGBAcolor satisfied an RGBcolor check with its alpha channel silently discarded. Both now raise ValidationError.Context.getPrimitiveInfo() no longer swallows every exception from the texture and solid-fraction getters. Only NotImplementedError (the getter absent from an older library build) leaves those fields as None; genuine native errors propagate, and each getter is attempted independently so one failure cannot suppress the others.Context.rotateObject(objID, angle, "z") now rotates in the opposite direction than it did previously. The native CompoundObject::rotate() "z" string-axis branch alone negated the rotation angle, disagreeing with rotatePrimitive() and with the vec3-axis rotateObject() overload; the negation is removed so all three rotation paths share one handedness. PyHelios passes the angle through unchanged at every layer, so this lands directly in the Python API. Any code that compensated for the old flipped azimuth by negating its angle is now rotating the wrong way and must drop the compensation.getObjectBoundingBox() returning a degenerate box for a single-primitive object. The native implementation seeds the box from the first primitive's first vertex and then continues to the next primitive, so the remaining vertices of that primitive are never compared against the seed. An object made of one primitive — a 1x1 tile, for example — therefore reports min == max == its first vertex, and any object list whose first object holds a unique extreme loses that extreme. getObjectBoundingBox([]) likewise returns a plausible-looking (0,0,0)–<tt>(0,0,0)box rather than failing, because the Python wrapper zero-initializes its output buffers; once fixed, a request covering no primitives raises instead. The fix belongs to the Helios repository, not to PyHelios (PyHelios must never patch the vendored helios-core submodule); it is applied there in core/src/Context.cpp with three accompanying core self-tests, and lands in PyHelios when the submodule pointer advances past v1.3.78. The new PyHelios tests assert the fixed behavior and are marked xfail until then. The pre-existing bounding-box tests — in both repos — passed only because they used a box object, whose six faces cover each other's extremes, masking the skipped face.
rotatePrimitive() and rotateObject(), which previously had none across their 14 wrapped entry points — the reason the z-axis handedness change above would have passed the suite unnoticed. The new tests pin the rotation convention (a +90° z-rotation maps (x,y) → (y,−x)) and assert that the string-axis, vec3-axis, primitive, and object paths all agree, so a future divergence in any one of them fails loudly. Verified by re-introducing the old negation and confirming only the z case goes red.about_origin=True on rotateObject() and scaleObject(). Both docstrings claimed the operation was about the global origin (0,0,0); the native rotateObjectAboutOrigin()/scaleObjectAboutOrigin() actually use the object's own stored object_origin, so an object built away from the world origin spins or scales in place rather than orbiting (0,0,0). Only the documentation was wrong — no behavior changed. To rotate about a specific point, pass it as origin.addDisk()/addDiskObject() (ndivs=int2(nr, ntheta) with ntheta >= 2) no longer leaves the first triangle of each outer ring stranded at the world origin, and getDomainBoundingBox(uuids=[...]) no longer returns an under-sized upper bound when the same vertex also set a new lower bound on that axis.Context.__del__ printing a spurious traceback at interpreter exit. A Context still alive when the interpreter shuts down is finalized after module globals and the import machinery have been torn down, so context_wrapper.destroyContext could already be gone. The destructor called it unguarded and then ran import warnings inside its except handler — but importing is no longer possible at that point, so the handler itself raised and CPython printed Exception ignored in: <function Context.__del__> with a traceback pointing at the import line, hiding the original error. warnings is now imported at module scope and the handler cannot raise. This was cosmetic teardown noise rather than a leak (the OS reclaims the allocation at process exit either way), but it produced an alarming and misleading traceback. Reported as GitHub issue #4.writeCameraImage() reporting invalid map<K, T> key for an unrendered camera. Camera pixel data is populated only by runBand(), and only for the bands passed to that call and for cameras that already existed when it ran. Writing an image for a camera/band outside that set reached std::map::at in the native library and surfaced as a bare STL message with no indication of the cause. writeCameraImage() and writeNormCameraImage() now check the precondition first and raise a RadiationModelError naming the camera, the band, and the missing runBand() call. The underlying library guard lands in helios-core v1.3.79; this check remains useful for earlier cores. Reported as GitHub issue #4.updateGeometry() → runBand() → write) and corrected two examples in plugin_radiation.md that would fail if copied: the time-series capture loop never called runBand(), and the complete-pipeline example wrote images from two cameras it never created.addSunSphereRadiationSource() placing the sun in the wrong position. The Python API documents zenith/azimuth in degrees, but the C interface passed them unconverted into SphericalCoord(radius, elevation_radians, azimuth_radians) — wrong units and wrong angle convention. An overhead sun (zenith=0) yielded 0 W/m² absorbed instead of the source flux. Degrees are now converted to radians and zenith to elevation; absorbed flux follows the cosine law.wavelength_min/wavelength_max arguments to addRadiationBand() and copyRadiationBand(): nanometers, not micrometers (the values were always passed through unscaled, so no behavior changed).getTotalAbsorbedFlux() returns flux density in W/m² per primitive, not power in watts — so sum() over the result is not physically meaningful; weight by getPrimitiveArea() to obtain watts.emission_enabled_<band> global data that helios-core 1.3.78's runBand() writes for every band (uint, 1/0). It records which band governs longwave emission, which the energy balance model reads to select the emitting band's emissivity. It needs no new wrapper — the existing Context.getGlobalData() uint path returns it.emissivity_[*] input primitive data, which was missing from the PyHelios input-data table entirely. helios-core 1.3.78 also defined which emissivity is used when the energy balance runs over multiple bands: the emissivity of the single band for which emission is enabled, falling back to the first emission-enabled band (with a warning) if several emit, and to the first band that defines an emissivity when no emission information is available — the case a script hits when it sets radiation fluxes manually without running the RadiationModel.addGrid() accepts an optional column_z_offsets argument that shifts each vertical column of voxels in z by a per-column amount, so a grid can track an external terrain surface such as a DEM. The offsets are row-major as [j*ndiv[0] + i], one value per (x,y) column, and are validated to have length ndiv[0]*ndiv[1]. Omitting the argument (or passing all zeros) builds the axis-regular grid exactly as before.getCellRotation(), which reports a grid cell's azimuthal rotation about the z-axis in degrees. This getter was previously unwrapped in PyHelios; helios-core 1.3.78 also changed its native units from radians to degrees, so it now matches the units expected by addGrid().getCellCenter() now returns the true world-space center of a grid cell. For a grid built with a non-zero rotation, the native library previously returned the raw un-rotated lattice center, which did not lie in the same frame as the hit points, scan origins, or grid bounding box; it is now rotated about the grid anchor to match. Un-rotated grids are unaffected. Code that consumed getCellCenter() for a rotated grid and compensated for the missing rotation must drop that compensation.addGrid() rotation argument: degrees, not radians. The native addGrid() converts degrees internally, so a caller who followed the previous documentation and passed radians got a grid rotated by roughly 1/57th of the intended angle. No behavior changed — the value was always passed through unscaled — but the documentation was wrong. Note that addGridCell() genuinely does take radians (it stores the angle directly), so the two entry points differ; this asymmetry is inherited from the native API and is now documented on both methods.getPlantAge(), getPlantHeight(), and sumPlantLeafArea() now raise on failure instead of returning -1.0, which was indistinguishable from a real measurement.wehrli.dat, abscoef.dat) being omitted from wheels, which made calculateSpectralIrradiance() fail on installed packages. The assets are now packaged, with the source path assets/ssolar_goa flattened to the plugins/solarposition/ssolar_goa location the C++ runtime opens.setTileObjectSubdivisionByAreaRatio() now validates that area_ratio >= 1 (raising ValueError otherwise) and its documentation is corrected: area_ratio is the ratio of the whole tile's area to an individual sub-patch's area (i.e. the approximate sub-patch count), not the sub-patch-to-tile fraction.addScanRisley() registers a non-repetitive rosette scan from a stack of rotating wedge prisms (the new RisleyPrism type — wedge_angle, refractive_index, rotor_rate, phase), a refractive index of air, a pulse repetition rate, and a 6-DOF trajectory (quaternion or Euler). The per-pulse beam direction is computed by full Snell's-law refraction through the prisms; the scan is stored as a single-row table with ScanMode.RISLEY_PRISM / ScanPattern.RISLEY_PRISM (new enum values). Query it with getScanRisleyPrisms() and getScanRisleyRefractiveIndexAir().isGPUAvailable() (compiled with CUDA, a device present, and HELIOS_NO_GPU unset) and isGPUAccelerationEnabled() (whether GPU acceleration is currently toggled on).syntheticScan(): setSyntheticScanProgressPointer(ctypes.c_int) writes the 0-based index of the scan currently being ray-traced (set to getScanCount() when finished), and setProgressCallback(fn) invokes a Python callback with (progress_fraction, message) during the scan.setSyntheticScanMemoryBudget(bytes) to cap the transient ray-tracing scratch buffers syntheticScan() allocates when fanning each pulse into sub-rays, so a high-resolution scan is traced in chunks sized to the budget instead of one OOM-prone batch, plus getSyntheticScanMemoryBudget() to read it back (0 = automatic, path-dependent: 8 GiB on a GPU build, 4 GiB otherwise). The budget bounds only the live trace buffers, not the output cloud.getHitDataColumnIndex(label) to resolve a hit-data label to its internal column slot (−1 if never set), for repeated bulk access without re-resolving the label by string.setScanDetectionThreshold() (0 disables suppression, reproducing the previous "report every return" behavior).optionalOutputObjectData(labels) to enable additional per-object output fields to be written onto the Context's compound objects after building (e.g. age, rank, plantID, plant_height, phenology_stage, leafID, fruitID, carbohydrate_concentration, or "all"); accepts a single label or a list.RandomParameter (now an alias for RandomParameterFloat) and RandomParameterInt are the typed classes from pyhelios.plant_architecture_params and now return RandomParameterFloat/RandomParameterInt objects (round-trippable via to_dict()) rather than the previous plain dicts, with their factory methods (constant/uniform/normal/weibull and constant/uniform/discrete) now validating their arguments. defineShootType() accepts these objects embedded directly in a raw parameter dict.addScanSpinning() registers a continuously-rotating multibeam sensor (Velodyne/Ouster/Hesai) from per-channel elevation angles, an azimuth resolution, a pulse repetition rate (PRF), and a 6-DOF trajectory — deriving the azimuth grid, rotation rate, and revolution count internally — and addScanMovingRaster() sweeps a fixed angular fan along a quaternion trajectory. Both set a self-describing acquisition mode.addScanMultibeam() (breaking change). In helios-core 1.3.76 a spinning scan must be created through the physical-parameter path; the legacy grid constructor that addScanMultibeam() wrapped produces a non-self-describing STATIC_RASTER-mode scan that no longer round-trips through XML as a spinning scan. Use addScanSpinning() instead (pass per-channel elevation angles, an azimuth_step, a pulse_rate_hz, and a trajectory in place of zenith angles, Nphi, and phi_range).getScanMode() (new ScanMode enum: STATIC_RASTER/MOVING_RASTER/SPINNING), getScanStepsPerRev(), getScanRotationRate(), and getScanRevolutions().setScanReturnMode()/getScanReturnMode() (new ReturnMode enum: MULTI/SINGLE), setScanSingleReturnSelection()/getScanSingleReturnSelection() (new SingleReturnSelection enum: STRONGEST/FIRST/LAST/STRONGEST_PLUS_LAST), setScanMaxReturns()/getScanMaxReturns(), setScanPulseWidth()/getScanPulseWidth(), setScanDetectionThreshold()/getScanDetectionThreshold(), and a return_mode argument on syntheticScan() that overrides the stored mode for one call. The new echo_width per-hit data field (return range spread) is now available.getHitDataColumn(label) / getHitDataColumnArray(label), which use the native cache-linear column storage and return full float64 precision (with an absent_value placeholder), versus the float32 of getHitDataAll/getHitDataArray.setExternalTriangulation(vertices, scan_ids) to drive leaf-area inversion from an externally-supplied mesh (a re-used Helios triangulation or a per-scan open3d Ball-Pivot mesh) instead of the internal Delaunay triangulation, accepting the (T,9)/(T,3,3)/flat layouts getTriangleVerticesAll() exports plus a per-triangle source scan ID (required for the G(theta) ray direction); calculateLeafArea() then runs unchanged.syntheticScan() gained a cancel_flag argument (a caller-owned ctypes.c_int) that aborts a long scan between pulses when set non-zero from another thread, returning whatever was scanned so far.pyhelios.plant_architecture_params) mirroring the nested C++ ShootParameters/PhytomerParameters/LeafPrototype structures (plus flat CarbohydrateParameters/NitrogenParameters), with RandomParameterFloat/RandomParameterInt distribution specs and from_dict()/to_dict() round-tripping to the plain-dict JSON transport. getCurrentShootParameters() gained a return_typed keyword to return a ShootParameters object, and defineShootType() now accepts either a nested dict or a ShootParameters. getCurrentShootParameters() now also surfaces the full phytomer_parameters sub-structure (internode/petiole/leaf/peduncle/inflorescence and the leaf prototype).getDefaultCarbohydrateParameters()/setPlantCarbohydrateParameters() and getDefaultNitrogenParameters()/setPlantNitrogenParameters(). The native API has no per-plant getter for these, so the get methods return the C++ default-constructed template (flat dict or typed object via return_typed) to modify and apply to a plant instance.setPlantPhenologicalThresholds() gained an is_evergreen keyword (default False) that retains leaves through dormancy instead of shedding them at senescence, matching the helios-core 1.3.76 signature.setCancelFlag(cancel_flag) to register a caller-owned ctypes.c_int that, when set non-zero from another thread, stops the canopy-build and advanceTime() growth loops between plants/timesteps (returning whatever was built so far) — so a long generation can be aborted mid-build.addRadiationCamera() and updateCameraParameters() read the exposure field ("auto"/"manual"/"ISOXXX") from CameraProperties and pass it to helios-core, rather than always forcing "auto".writePrimitiveDataLabelMap() and writeObjectDataLabelMap() write a camera's per-pixel primitive/object data values (float/double/uint/int) to a row-major ASCII text file (background pixels get a configurable padvalue, default NaN), plus getPrimitiveDataLabelMap()/getObjectDataLabelMap() convenience wrappers that return the map directly as a 2D (height, width) NumPy array (written to a temp file and loaded, no file left on disk).calculateGtheta() now calls updateGeometry() automatically (with a warning) if the scene geometry hasn't been pushed to the radiation model yet, and raises an explicit RuntimeError when the G-function is undefined (no geometry / zero leaf area) instead of silently returning NaN.getHitsXYZRGBArrays() (returns (N,3) float32 coordinates and colors), getHitDataArray(label) ((N,) float32, NaN where the label is absent), getHitScanIDArray() ((N,) int32), and getHitMissArray() ((N,) int32, 1 = miss).addScanMoving() registers a scan driven by a timestamped 6-DOF pose trajectory (per-sample position plus orientation as quaternions or roll/pitch/yaw Euler angles), a sensor lever arm and boresight misalignment, and a pulse rate. The synthetic-scan generator emits a per-pulse origin and direction interpolated along the trajectory; every hit/miss records its own origin, timestamp, and firing index.getHitOrigin(index) returning the per-pulse beam-emission origin of a hit (the moving-platform origin, or the static scan origin as a fallback).addScan()/addScanMultibeam() gained a scan_azimuth_offset keyword (radians; default 0 = no offset), queryable via getScanAzimuthOffset(). It applies a right-hand rotation about the world +z axis on top of the azimuth sweep.calculateLeafArea() gained an optional Gtheta argument: when supplied (with min_voxel_hits and element_width), leaf area is computed via a triangulation-free, beam-origin-aware inversion using the caller-supplied G(theta). This is the supported leaf-area path for moving-platform scans, whose pulses cannot be triangulated.setPrimitiveData*()/setObjectData*() now accept a list of values (one per UUID/objID) to assign a distinct value to each element in a single bulk call, complementing the existing scalar-broadcast behavior (a scalar still applies the same value to every ID). Covers all 11 data types (int, uint, float, double, string, vec2, vec3, vec4, int2, int3, int4).overridePrimitiveTextureColor() and usePrimitiveTextureColor() now accept a list of UUIDs, applying the override/restore to all of them in one bulk call (previously single-UUID only).incrementPrimitiveData() gained an optional data_type keyword (‘'int’/'uint'/'float'/'double'`) to target a specific field type, and now supports unsigned-int and double fields in addition to the existing int/float overloads.LiDARCloud.addHitPointsWithData() for bulk in-memory hit ingestion carrying a per-hit data map: like addHitPoints() but populates each hit's named-scalar data map (the in-memory equivalent of what the ASCII loader does for non-standard columns), so values like timestamp/target_index/target_count land in the map for multi-return grouping. Uses the full SphericalCoord (radius retained for Beer's-law path length).LiDARCloud.getTriangleVerticesAll() to bulk-export every triangulated triangle's three vertices (and source scan ID) in a single call as flat numpy arrays, reading directly off the LiDARcloud and bypassing the Context round-trip and per-triangle vertex loop.LiDARCloud.getTriangulationStats() returning the filter diagnostics from the most recent triangulateHitPoints() call as a dict (candidates, dropped_lmax, dropped_aspect, dropped_degenerate); each dropped triangle is attributed to one primary reason so candidates == getTriangleCount() + dropped_lmax + dropped_aspect + dropped_degenerate, distinguishing a data-limited mesh (few candidates) from a filter-limited one (many candidates dropped by Lmax/aspect).calculateLeafArea() fails fast with an explicit error if the point cloud contains no misses (fired pulses that returned nothing), rather than silently producing biased leaf area density. LiDARCloud.syntheticScan() now records misses by default for discrete-return scans as well as full-waveform (the discrete path is routed through a new miss-aware native overload honoring scan_grid_only/record_misses); import workflows can synthesize misses with gapfillMisses(). Added hasMisses(), isHitMiss(index), and the static getMissDistance() (the LIDAR_MISS_DISTANCE constant) to inspect misses.addScan() gained scan_tilt_roll/scan_tilt_pitch keyword arguments (radians; default 0 = level), queryable via getScanTiltRoll()/getScanTiltPitch(). Models the residual tilt of the scanner spin axis away from plumb.addScanMultibeam() registers a rotating multi-channel scan from a list of per-channel zenith angles, and getScanPattern() (returning the new ScanPattern enum: RASTER/SPINNING_MULTIBEAM) and getScanBeamZenithAngles() query the pattern.calculateLeafArea() gained an optional element_width argument that, alongside the leaf-area estimate, computes the sampling variance, exposed through getCellLADVariance(), getCellBeamCount(), getCellRelativeDensityIndex(), getCellMeanPathLength(), single-voxel getCellLeafAreaConfidenceInterval(), group-scale getGroupLADConfidenceInterval() (recommended), and the exportLeafAreaUncertainty() file export.exportPointCloud() gained a write_header argument (default True): exports now prepend a #-prefixed column-name header line (CloudCompare convention) that round-trips through loadXML().getAllShootIDs()/getPlantShoot(): PlantArchitecture.getAllShootIDs() returns the contiguous 0-based shoot IDs for a plant (shoot 0 is the base stem), getShoot() returns a shoot's topology dict (rank, parent_shoot_id (-1 for the base stem), parent_node_index, node_count), getShootChildIDs() returns its child shoot IDs, and getShootInternodeVertices()/getShootInternodeRadii() return its woody internode polyline geometry.clearAllPrimitiveData(label) and clearAllObjectData(label) to remove a named data field from every primitive/compound object in the Context (including hidden ones) and release the registered data type for that label, complementing the existing per-UUID/per-objID clearPrimitiveData()/clearObjectData().deleteTimeseriesDataPoint(date, time, label=None) to delete a single timeseries data point at a given date/time — for one variable when label is given, or across all variables when label is None.Location gained an altitude field (meters above sea level, default 0.0); setLocation() accepts an optional altitude in its float form, getLocation() now returns it, and make_Location() accepts an optional 4th argument. Existing 3-argument usage is unchanged. Note Helios's non-standard longitude convention (+W / −E), which is auto-flipped to the standard +E convention when written into camera EXIF metadata.CameraProperties gained a manufacturer field (helios-core v1.3.73 maps it to the EXIF camera Make tag; empty ⇒ "Helios"). Like the other CameraProperties string fields, it is exposed on the Python class for forward compatibility but is not yet plumbed through to the native camera. Camera images written via writeCameraImage() embed EXIF/XMP metadata (camera intrinsics, orientation, and GPS derived from the Context Location) automatically on the native side.LiDARCloud.addScan() gained optional range_noise_stddev (meters) and angle_noise_stddev (radians) arguments that drive realistic anisotropic positional error during syntheticScan() (along-beam range noise and across-beam beam-pointing jitter). Both default to 0.0 (disabled), preserving prior behavior. Query them with getScanRangeNoiseStdDev(scanID) / getScanAngleNoiseStdDev(scanID).exportScans(filename) to write all scans as an XML metadata file plus one ASCII data file per scan (auto-named <base>_<scanID>.xyz), re-loadable with loadXML().doesObjectExist(), doesObjectContainPrimitive(), doesMaterialDataExist(), objectHasTexture(), isPrimitiveDirty(), areObjectPrimitivesComplete(), getJulianDate(), getMaterialCount(), getObjectArea(), getObjectPrimitiveCount(), getPolymeshObjectVolume(), getMaterialIDFromLabel(), getPrimitiveMaterialID(), getGlobalDataVersion(), getPrimitiveParentObjectID(), getObjectTextureFile(), listAllPrimitiveDataLabels(), getLoadedXMLFiles(), printObjectInfo(), printPrimitiveInfo(), setObjectDataFromPrimitiveDataMean(), renameMaterial(), renamePrimitiveData(), clearMaterialData(), plus enable/disablePrimitiveDataValueCaching() and enable/disableObjectDataValueCaching()getDeletedUUIDs(), getDirtyUUIDs(), getUniquePrimitiveParentObjectIDs(), getObjectAverageNormal(), plus setObjectAverageNormal(), setObjectOrigin(), setPrimitiveAzimuth(), setPrimitiveElevation(), setTriangleVertices(), setPrimitiveNormal() (single/batch), and setPrimitiveParentObjectID() (single/batch)int, uint, float, double, string, vec2, vec3, vec4, int2, int3, int4): per-type explicit setMaterialData<Type>() and getMaterialData<Type>() methods, a unified setMaterialData()/getMaterialData() dispatcher with auto-detection via getMaterialDataType(), and getUniquePrimitiveDataValues()/getUniqueObjectDataValues() (int/uint/str)(4,4) float32 ndarrays (also accepting nested lists or flat 16-float lists): get/setObjectTransformationMatrix() and get/setPrimitiveTransformationMatrix() with single/batch dispatch, plus domain-level getDomainBoundingBox() and getDomainBoundingSphere() with optional UUID filteringsetTubeNodes(), setTubeRadii(), scaleTubeGirth(), scaleTubeLength(), pruneTubeNodes(), appendTubeSegment() (color or texture+uv kwargs), addPolymeshObject(), setObjectColor() (RGB/RGBA, single/batch), overrideObjectTextureColor()/useObjectTextureColor(), markPrimitiveDirty()/markPrimitiveClean(), setTileObjectSubdivisionCount(), and setTileObjectSubdivisionByAreaRatio()cleanDeletedUUIDs() and cleanDeletedObjectIDs() (returning new lists, not mutating input), writeXML()/writeXML_byobject() for XML export with optional UUID filtering, randu()/randn() random-number draws (uniform with optional float or int range; normal with optional mean/stddev), and geographic setLocation()/getLocation() returning the new Location dataclass (latitude, longitude, UTC offset)generateColormap(name, n_colors) returning an RGBcolor list, generateTexturesFromColormap() returning generated file paths, and getPrimitiveTextureTransparencyData() returning an Optional[np.ndarray] 2D bool maskdeleteTimeseriesVariable(label) to remove a single timeseries variable and all of its data points (complements the existing clearTimeseriesData() and updateTimeseriesData()).LeafOpticsProperties with two optional Fluspect-B SIF parameters: V2Z (violaxanthin↔zeaxanthin de-epoxidation state, default 0.0) and fqe (intrinsic fluorescence quantum-efficiency scalar, default 1.0). They are ignored by the pure PROSPECT reflectance/transmittance calculation; the radiation plugin's SIF pipeline reads them when active. The flat float-array layout grew from 9 to 11 entries; LeafOpticsProperties.from_list() still accepts both lengths for backward compatibility with serialized data.setModelTypeC4() and the von Caemmerer (2021) steady-state C4 model — setC4CoefficientsFromLibrary() / getC4CoefficientsFromLibrary() (species: SetariaViridis_vC2021, GenericC4_vC2000, Maize_Massad2007), setC4ModelCoefficients() / getC4ModelCoefficients() over a 43-float coefficient array (5 temperature-responsive rates × 4 floats: Vpmax/Vcmax/Jmax/Rd/gm; 5 K-25 + 5 dH kinetic constants; 13 user-tunable scalars), and setCm() for direct mesophyll CO₂ prescription (testing/validation). Both setC4CoefficientsFromLibrary() and setC4ModelCoefficients() accept a material_label keyword to apply coefficients per-material rather than per-UUID.setFarquharMesophyllConductance() to configure C3 mesophyll conductance gm (mol CO₂ / m² / s / bar) with optional temperature response. Default behaviour unchanged: gm = +∞ reduces Cc to Ci (legacy Farquhar).FarquharModelCoefficients flat array round-trip (to_array() / from_array() and the corresponding getFarquharModelCoefficients / setFarquharModelCoefficients C wrappers) grew from 18 to 22 floats: slots 18–21 carry (gm_at_25C, dHa, Topt_C, dHd) for the gm temperature response. from_array still accepts the legacy 18-float layout for back-compat (gm defaults to +∞); the C wrapper still accepts 18-float buffers and only consumes the gm slots when the buffer is at least 22 elements.limitation_state uses the convention 1 = enzyme-limited, 2 = electron-transport-limited (vs. C3's 0/1). New optional output primitive data labels for the C4 model: Cm (mesophyll cytosolic CO₂) and Vp (PEP carboxylation rate).addSIFCamera() (vec3 lookat and SphericalCoord overloads) plus the new SIFCameraProperties (extends CameraProperties with excitation_bin_width_nm and excitation_scattering_depth) and the isSIFCamera() query. SIF cameras source per-band emission from the Fluspect-B kernel rather than Stefan-Boltzmann; Helios auto-creates internal excitation bands covering 400–750 nm at the requested bin width.syntheticScan() already computes: LiDARCloud.getHitData(index, label), doesHitDataExist(index, label), and getHitScanID(index), reaching intensity, distance, timestamp, target_index, target_count, deviation, nRaysHit, and any column-format fields. Added bulk single-call exports getHitDataAll(label) and getHitsXYZRGB() for large clouds.column_format is now sampled from the struck primitive (FLOAT/DOUBLE/INT/UINT) onto each hit, replacing the previously hardcoded object_label/reflectivity_lidar pair (reflectivity_lidar retains its intensity-modulation behavior). LiDARCloud.addScan() gained an optional column_format argument (default keeps prior behavior); the previously auto-copied object_label must now be listed in column_format to transfer.writePlantStructureUSD() to export a plant as a USD articulated rigid body for NVIDIA IsaacSim physics (capsule links, spherical joints with E*I/L spring/damper drives, organ mass bodies)registerGrowthFrame(), writePlantGrowthUSD(), clearGrowthFrames(), and getGrowthFrameCount() for time-sampled USD animations importable into BlenderupdateTimeseriesData() method to replace the value of an existing timeseries data point at a specified (date, time)getObjectType(), getObjectCenter(), getObjectBoundingBox(), getObjectPrimitiveUUIDs() (single/list/nested), plus per-type getters for tile, sphere, box, disk, tube, and cone objects (center, size, subdivision count, normal, vertices, radius, node/radius data, axis, length, volume)getPatchCenter(), getPatchSize(), getTriangleVertex(), getVoxelCenter(), getVoxelSize(), getPatchCount(), getTriangleCount(), getPrimitiveBoundingBox() (single UUID or list)setPrimitiveColor() for mutating the color of one primitive or a list of primitives, accepting either RGBcolor or RGBAcolorclearPrimitiveData() and listPrimitiveData() for removing and inspecting per-primitive data fieldscropDomainX(), cropDomainY(), cropDomainZ(), and cropDomain() to restrict all primitives (or a supplied UUID list) to given XYZ boundsinclude_hidden parameter to getAllPlantUUIDs() to allow querying hidden prototype primitivesdeletePlantInstance() now automatically cleans up hidden prototype primitives when all plant instances have been deleteddoesPrimitiveExist() method to check whether primitives exist by single UUID or list of UUIDsresolveMaterialTextures() method for material-based texture suppression resolution (modifies colors in-place, returns resolved texture paths)packGPUBuffers() method to pack GPU-ready geometry buffers into a single binary blob for zero-copy Three.js BufferGeometry loadingaddPatchTextured() method for creating textured patches with optional UV coordinatesclearTimeseriesData() method to remove all timeseries variables and their associated date/time values from the Contextgermination_rate parameter to buildPlantCanopyFromLibrary() to control the fraction of grid positions occupied by plantssetProgressCallback() for receiving (progress, message) updates during long-running operations like advanceTime()getPrimitiveTextureFile(), setPrimitiveTextureFile(), getPrimitiveTextureSize(), getPrimitiveTextureUV(), primitiveTextureHasTransparencyChannel(), getPrimitiveSolidFraction(), overridePrimitiveTextureColor(), usePrimitiveTextureColor(), isPrimitiveTextureColorOverridden()getPrimitiveNormal([uuid1, uuid2]) returns an ndarray of shape (N, 3))getAll* convenience methods that query all primitives in the context (e.g., getAllPrimitiveNormals())PrimitiveInfo with texture_file, texture_uv, and solid_fraction fieldsaddTimeseriesData(), setCurrentTimeseriesPoint(), queryTimeseriesData(), queryTimeseriesDate(), queryTimeseriesTime(), getTimeseriesLength(), doesTimeseriesVariableExist(), listTimeseriesVariables(), loadTabularTimeseriesData()writeCameraImageDataEXR(), writeDepthImageData(), writeDepthImageDataEXR(), writeNormDepthImage()getBackendName() and probeAnyGPUBackend() for runtime GPU backend detectionisinstance()-based type validation to PlantArchitecture and RadiationModel methods per argument type validation policyvalidate_position_like(), validate_direction_like(), and validate_size_like() validators for flexible parameter typesVK_ICD_FILENAMES for bundled MoltenVK on macOStests/manual/ directory from automatic pytest collectionPYHELIOS_TEST_VISUALIZER is set)🚨++ New Plug-in Integrated ++ 🚨
Context.seedRandomGenerator() for reproducible stochastic simulationsenableGPUAcceleration(), disableGPUAcceleration(), isGPUAccelerationEnabled(), and isGPUAccelerationAvailable()pytest-forked was missing from standard pyhelios dependenciesmagnitude() and normalize() methods to vec2 and vec3scale() method to RGBcolor and RGBAcolor for color intensity adjustmentJulianDay(), incrementDay(), and isLeapYear() methods to DatescaleConeObjectLength() and scaleConeObjectGirth() methods for cone object manipulationsetAtmosphericConditions(), getAtmosphericConditions(), and parameter-free flux methodsgetAmbientLongwaveFlux() for ambient longwave radiation calculationenablePragueSkyModel(), updatePragueSkyModel(), isPragueSkyModelEnabled(), and pragueSkyModelNeedsUpdate()optionalOutputPrimitiveData() for selective biochemical property output (chlorophyll, carotenoid, water, etc.)loadXML() method for loading custom tree species from XML filesbuildTree() to accept custom species names (strings) in addition to WPTType enum🚨++ New Plug-in Integrated ++ 🚨
addMaterial(), setMaterialColor(), setMaterialTexture(), and material assignment methodsaddRadiationCameraFromLibrary() for preconfigured camera modelsupdateCameraParameters() and enableCameraMetadata() for camera managementcalculateDirectSolarSpectrum(), calculateDiffuseSolarSpectrum(), and calculateGlobalSolarSpectrum()__del__ methods, which should be fixed now.Context.setPrimitiveData[*]() to accept a list of UUIDsContext.deletePrimitive() and Context.deleteObject() methodsContext.writePrimitiveData() method to write primitive data to a fileaddRectangleRadiationSource(), addDiskRadiationSource()setSourcePosition(), getSourcePosition(), deleteRadiationSource()setSourceSpectrum(), integrateSpectrum(), scaleSpectrum(), blendSpectra()setDiffuseRadiationExtinctionCoeff(), setDiffuseSpectrum(), getDiffuseFlux()doesBandExist(), getSkyEnergy(), calculateGtheta(), enforcePeriodicBoundary()copyRadiationBand() to support optional wavelength range parametersaddPlantInstance(), addBaseStemShoot(), and addChildShoot()plantDoesCollide()AxisRotation data type for shoot rotation controlplantarch_custom_building_sample.py, plantarch_collision_sample.py, plantarch_file_io_sample.pypyhelios_build directorypyhelios/runtime/ directory to git control🚨++ New Plug-in Integrated ++ 🚨
🚨++ New Plug-in Integrated ++ 🚨
Improved Error Handling, Build System Optimization, and Testing Infrastructure
🎉PyPI package distribution should now be working for all integrated plug-ins 🎉
Enhanced Build System and GPU Runtime Detection
PyPI Package Distribution Fixes
Many documentation error fixes
writePLY(), writeOBJ() methods with comprehensive parameter support🎉++ PyPI Package Distribution ++ 🎉
pip install pyhelios3d🚨++ New Plug-in Integrated ++ 🚨
🚨++ New Plug-in Integrated ++ 🚨
🚨++ New Plug-in Integrated ++ 🚨
--plugins visualizer)🚨++ New Plug-in Integrated ++ 🚨
Visualizer.colorContextPrimitivesByData()Context.loadPLY(), Context.loadOBJ(), and Context.loadXML() methodsContext.loadPLY() with 5 overloads supporting origin, height, rotation, color, and upaxis transformationsContext.loadOBJ() with 4 overloads including scale transformations and upaxis specificationContext.loadXML() implementation for Helios XML geometry filesContext.addTriangleTextured()Context.addTrianglesFromArraysTextured()suzanne.ply, suzanne.obj, suzanne.mtl, and leaf_cube.xmlexternal_geometry_sample.py and stanford_bunny_radiation.py for demonstrationaddTile(), addSphere(), addTube(), addBox(), and addCone() methods (with color variants)primitive_data_array_example.py demonstrating numpy array integrationstanford_bunny_radiation.py with improved visualization workflowsimple_radiation_test.pyFix helios-core submodule to point to correct remote commit
🎉 Initial version! 🎉
visualizerradiationweber-penn tree 
1.13.2