hayodea/salmanoff
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 2 Wiki Activity

PcloudAmbienceStimBuff: Updated to use postrin percentage

Browse Source
This commit is contained in:
Hayodea Hekol
2025-12-02 16:17:00 -04:00
parent 7ebdf14eb7
commit 5dffbd0c91
3 changed files with 22 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/design/intrin-thresholds.md
+12 -5
View File
@@ -12,10 +12,16 @@ importance classifications.
## Interest Threshold Parameters ## Interest Threshold Parameters
**Synonyms:** **Synonyms:**
- `postrin-interest-percentage`
- `postrin-interest-pc`
- `postrin-interest-threshold` - `postrin-interest-threshold`
- `postrin-interest-th` (abbreviation for `-threshold`)
- `interest-threshold` - `interest-threshold`
- `postrin-interest` - `postrin-interest`
- `negtrin-interest-percentage`
- `negtrin-interest-pc`
- `negtrin-interest-threshold` - `negtrin-interest-threshold`
- `negtrin-interest-th` (abbreviation for `-threshold`)
- `negtrin-interest` - `negtrin-interest`
**Description:** **Description:**
@@ -27,8 +33,9 @@ postrinInd/negtrinInd with the "importance" argument set to "INTERESTING".
**Specification:** **Specification:**
- The parameter is specified as part of the `quale-iface-api-params` - The parameter is specified as part of the `quale-iface-api-params`
in the DAP specification in the DAP specification
- The value is a numeric threshold that determines when stencils are - Parameters with the `-percentage` or `-pc` suffix are interpreted as percentages (0-100)
constructed and delivered with INTERESTING importance - 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) - If multiple synonyms are specified, the lattermost (last encountered)
synonym takes precedence synonym takes precedence
- Separate thresholds can be specified for postrin and negtrin using the - 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:** **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 This example sets the interest threshold to 50% for postrins (percentage-based) and 30 for
negtrins. negtrins (absolute threshold value).
## Distraction Threshold Parameters ## Distraction Threshold Parameters
docs/livox-gen1-lidar-dap-spec.md
+8 -6
View File
@@ -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): **Intrinsic Stimuli Support** (for pcloudAmbience quale-iface-api):
The `pcloudAmbience` quale-iface-api exports both a postrin and a negtrin whose The `pcloudAmbience` quale-iface-api exports both a postrin and a negtrin whose
thresholds are configurable via standard quale-iface-api-params: thresholds are configurable via standard quale-iface-api-params:
- **Postrin interest threshold**: Configurable via `postrin-interest-threshold` / `postrin-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-threshold` / `negtrin-interest` (default: 30) - **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 The postrin interest threshold is percentage-based only (0-100) and specifies the
postrin, and frames whose average intensity is >= negtrin-interest-threshold percentage of frames whose average intensity must be <= the ambience intensity low
qualify for negtrin. The ambience count written to each stimFrame is the number value threshold. Frames whose average intensity is <= the ambience intensity low
of frames that qualify for either intrinsic. 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) ### 3. Point Cloud Coordinate Data Device (Extrospector)
stimBuffApis/livoxGen1/pcloudAmbienceStimulusBuffer.h
+2 -1
View File
@@ -42,7 +42,8 @@ public:
{ {
// Parse postrinInterestPercentage (interpreted as percentage 0-100) // Parse postrinInterestPercentage (interpreted as percentage 0-100)
const std::vector<std::string> postrinInterestThresholdParamNames = { const std::vector<std::string> postrinInterestThresholdParamNames = {
"postrin-interest-threshold", "postrin-interest-percentage",
"postrin-interest-pc",
"postrin-interest" "postrin-interest"
}; };