diff --git a/docs/design/intrin-thresholds.md b/docs/design/intrin-thresholds.md index 76135c2..4bc7c9f 100644 --- a/docs/design/intrin-thresholds.md +++ b/docs/design/intrin-thresholds.md @@ -12,10 +12,16 @@ importance classifications. ## Interest Threshold Parameters **Synonyms:** +- `postrin-interest-percentage` +- `postrin-interest-pc` - `postrin-interest-threshold` +- `postrin-interest-th` (abbreviation for `-threshold`) - `interest-threshold` - `postrin-interest` +- `negtrin-interest-percentage` +- `negtrin-interest-pc` - `negtrin-interest-threshold` +- `negtrin-interest-th` (abbreviation for `-threshold`) - `negtrin-interest` **Description:** @@ -27,8 +33,9 @@ postrinInd/negtrinInd with the "importance" argument set to "INTERESTING". **Specification:** - The parameter is specified as part of the `quale-iface-api-params` in the DAP specification -- The value is a numeric threshold that determines when stencils are - constructed and delivered with INTERESTING importance +- Parameters with the `-percentage` or `-pc` suffix are interpreted as percentages (0-100) +- Parameters with the `-threshold` or `-th` suffix are interpreted as absolute threshold values +- The `-threshold` suffix can be abbreviated as `-th` - If multiple synonyms are specified, the lattermost (last encountered) synonym takes precedence - Separate thresholds can be specified for postrin and negtrin using the @@ -36,11 +43,11 @@ postrinInd/negtrinInd with the "importance" argument set to "INTERESTING". **Example:** ``` -+idev|my-device|pcloudIntensity(postrin-interest-threshold=50|negtrin-interest-threshold=30)|livoxGen1-pcloudIntensity()|livoxProto1()|3JEDK380010Z39 ++idev|my-device|pcloudIntensity(postrin-interest-percentage=50|negtrin-interest-threshold=30)|livoxGen1-pcloudIntensity()|livoxProto1()|3JEDK380010Z39 ``` -This example sets the interest threshold to 50 for postrins and 30 for -negtrins. +This example sets the interest threshold to 50% for postrins (percentage-based) and 30 for +negtrins (absolute threshold value). ## Distraction Threshold Parameters diff --git a/docs/livox-gen1-lidar-dap-spec.md b/docs/livox-gen1-lidar-dap-spec.md index 0c24d7a..684ccfb 100644 --- a/docs/livox-gen1-lidar-dap-spec.md +++ b/docs/livox-gen1-lidar-dap-spec.md @@ -46,13 +46,15 @@ Each stim-buff-api is designed to work with specific stim-iface libraries that u **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) +- **Postrin interest threshold**: Configurable via `postrin-interest-percentage` / `postrin-interest-pc` / `postrin-interest` (default: 90, interpreted as percentage) +- **Negtrin interest threshold**: Configurable via `negtrin-interest-percentage` / `negtrin-interest-pc` / `negtrin-interest-threshold` / `negtrin-interest-th` / `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. +The postrin interest threshold is percentage-based only (0-100) and specifies the +percentage of frames whose average intensity must be <= the ambience intensity low +value threshold. Frames whose average intensity is <= the ambience intensity low +value qualify for postrin, and frames whose average intensity is >= the 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) diff --git a/stimBuffApis/livoxGen1/pcloudAmbienceStimulusBuffer.h b/stimBuffApis/livoxGen1/pcloudAmbienceStimulusBuffer.h index ba21f94..4154a5b 100644 --- a/stimBuffApis/livoxGen1/pcloudAmbienceStimulusBuffer.h +++ b/stimBuffApis/livoxGen1/pcloudAmbienceStimulusBuffer.h @@ -42,7 +42,8 @@ public: { // Parse postrinInterestPercentage (interpreted as percentage 0-100) const std::vector postrinInterestThresholdParamNames = { - "postrin-interest-threshold", + "postrin-interest-percentage", + "postrin-interest-pc", "postrin-interest" };