OClCollMeshEngn: Produce ambience count; set postrin threshold

We modify the semantics/meaning of the ambience stim feature.
It now represents the number of frames whose average intensity
is below the ambienceLowVal.

We can now implement the postrin as the event wherein the number
of frames whose intensity <= ambienceLowVal exceeds
postrin-interest-threshold.
This commit is contained in:
2025-11-28 00:12:18 -04:00
parent 5b19a70c75
commit 280b6f7d1c
7 changed files with 300 additions and 163 deletions
+12 -10
View File
@@ -33,7 +33,7 @@ Each stim-buff-api is designed to work with specific stim-iface libraries that u
### 2. Point Cloud Ambience Data Device (Interoceptor)
**Purpose**: Provides ambience data from the LiDAR point cloud, counting high-intensity points per slot.
**Purpose**: Provides ambience data from the LiDAR point cloud, computing average intensity per frame and counting frames that qualify for intrinsic stimuli.
**Syntax**:
```
@@ -41,16 +41,18 @@ Each stim-buff-api is designed to work with specific stim-iface libraries that u
```
**Stim-Buff-API**: `livoxGen1-pcloud`
**Quale-Iface-API**: `pcloudAmbience` - Counts points with intensity >= threshold per slot
**Quale-Iface-API**: `pcloudAmbience` - Computes average intensity per frame and exports postrin/negtrin based on configurable thresholds
**Postrin Support** (for pcloudAmbience quale-iface-api):
The `pcloudAmbience` quale-iface-api can supply postrins (positive intrinsic
stimuli). The default threshold values for postrin importance levels are:
- **Stupefaction threshold**: 0 (postrin-stupefaction-threshold=0)
- **Postrin distraction threshold**: 10 (postrin-distraction=10)
- **Postrin interest threshold**: 30 (postrin-interest-threshold=30)
These thresholds can be configured via `quale-iface-api-params` to override
the defaults.
**Intrinsic Stimuli Support** (for pcloudAmbience quale-iface-api):
The `pcloudAmbience` quale-iface-api exports both a postrin and a negtrin whose
thresholds are configurable via standard quale-iface-api-params:
- **Postrin interest threshold**: Configurable via `postrin-interest-threshold` / `postrin-interest` (default: 30)
- **Negtrin interest threshold**: Configurable via `negtrin-interest-threshold` / `negtrin-interest` (default: 30)
Frames whose average intensity is <= postrin-interest-threshold qualify for
postrin, and frames whose average intensity is >= negtrin-interest-threshold
qualify for negtrin. The ambience count written to each stimFrame is the number
of frames that qualify for either intrinsic.
### 3. Point Cloud Coordinate Data Device (Extrospector)