PcloudStimProd: ambienceHighVal is now a negtrin threshold
This commit is contained in:
@@ -37,20 +37,12 @@ Each stim-buff-api is designed to work with specific stim-iface libraries that u
|
|||||||
|
|
||||||
**Syntax**:
|
**Syntax**:
|
||||||
```
|
```
|
||||||
+idev | avia0 | pcloudAmbience | livoxGen1-pcloud(high-val=120) | livoxProto1(command-timeout-ms=1000,retry-delay-ms=3000,smo-ip=192.168.1.50,smo-subnet-nbits=24) | 3JEDK380010Z39
|
+idev | avia0 | pcloudAmbience | livoxGen1-pcloud() | livoxProto1(command-timeout-ms=1000,retry-delay-ms=3000,smo-ip=192.168.1.50,smo-subnet-nbits=24) | 3JEDK380010Z39
|
||||||
```
|
```
|
||||||
|
|
||||||
**Stim-Buff-API**: `livoxGen1-pcloud`
|
**Stim-Buff-API**: `livoxGen1-pcloud`
|
||||||
**Quale-Iface-API**: `pcloudAmbience` - Counts points with intensity >= threshold per slot
|
**Quale-Iface-API**: `pcloudAmbience` - Counts points with intensity >= threshold per slot
|
||||||
|
|
||||||
**Ambience High Value Parameter** (for pcloudAmbience quale-iface-api):
|
|
||||||
- **Parameter names**: `high-value` or `high-val` (synonyms)
|
|
||||||
- **Purpose**: Threshold value for counting high-intensity points in the ambience buffer
|
|
||||||
- **Default value**: 116
|
|
||||||
- **Usage**: Points with intensity >= `ambienceHighVal` are counted in the ambience buffer per slot
|
|
||||||
- **Configuration**: Specified in `stim-buff-api-params` when using `pcloudAmbience` quale interface
|
|
||||||
- **Example**: `high-val=120` or `high-value=120`
|
|
||||||
|
|
||||||
**Postrin Support** (for pcloudAmbience quale-iface-api):
|
**Postrin Support** (for pcloudAmbience quale-iface-api):
|
||||||
The `pcloudAmbience` quale-iface-api can supply postrins (positive intrinsic
|
The `pcloudAmbience` quale-iface-api can supply postrins (positive intrinsic
|
||||||
stimuli). The default threshold values for postrin importance levels are:
|
stimuli). The default threshold values for postrin importance levels are:
|
||||||
@@ -181,7 +173,6 @@ Each stim-buff-api accepts device-specific parameters:
|
|||||||
|-----------|-------------|---------|---------|
|
|-----------|-------------|---------|---------|
|
||||||
| `data-rate-hz` | Data sampling rate in Hz | - | `data-rate-hz=10` |
|
| `data-rate-hz` | Data sampling rate in Hz | - | `data-rate-hz=10` |
|
||||||
| `n-dgrams-per-frame` / `num-dgrams-per-frame` | Number of UDP datagrams per staging buffer frame | 84 | `n-dgrams-per-frame=84` or `num-dgrams-per-frame=84` |
|
| `n-dgrams-per-frame` / `num-dgrams-per-frame` | Number of UDP datagrams per staging buffer frame | 84 | `n-dgrams-per-frame=84` or `num-dgrams-per-frame=84` |
|
||||||
| `high-value` / `high-val` | Threshold for counting high-intensity points in ambience buffer (for `pcloudAmbience` quale-iface-api) | 116 | `high-val=120` or `high-value=120` |
|
|
||||||
|
|
||||||
### Quale-Iface-API Parameters
|
### Quale-Iface-API Parameters
|
||||||
|
|
||||||
@@ -195,8 +186,6 @@ The `pcloud` quale-iface-api accepts format parameters:
|
|||||||
| `dual-cartesian` | Dual Cartesian coordinate system |
|
| `dual-cartesian` | Dual Cartesian coordinate system |
|
||||||
| `dual-spherical` | Dual spherical coordinate system |
|
| `dual-spherical` | Dual spherical coordinate system |
|
||||||
|
|
||||||
The `pcloudAmbience` quale-iface-api uses the `high-value` / `high-val` parameter (documented in Stim-Buff-API Parameters above) to determine the intensity threshold for counting high-intensity points per slot.
|
|
||||||
|
|
||||||
## Device Discovery and Connection
|
## Device Discovery and Connection
|
||||||
|
|
||||||
The specification uses a retry-based connection strategy with two different approaches:
|
The specification uses a retry-based connection strategy with two different approaches:
|
||||||
|
|||||||
@@ -308,14 +308,16 @@ std::cout << __func__ << ": $$$$$$$ Created PcloudIntensityStimulusBuffer" << st
|
|||||||
}
|
}
|
||||||
else if (qualeIfaceApi == "pcloudAmbience")
|
else if (qualeIfaceApi == "pcloudAmbience")
|
||||||
{
|
{
|
||||||
// Parse ambienceHighVal from stimBuffApiParams
|
// Parse ambienceHighVal from qualeIfaceApiParams (temporary, undocumented)
|
||||||
const std::vector<std::string> ambienceHighValParamNames = {
|
const std::vector<std::string> ambienceHighValParamNames = {
|
||||||
"high-value",
|
"negtrin-intolerable-threshold",
|
||||||
"high-val"
|
"negtrin-intolerable",
|
||||||
|
"intolerable-threshold",
|
||||||
|
"intolerable"
|
||||||
};
|
};
|
||||||
int ambienceHighValInt = device::DeviceAttachmentSpec
|
int ambienceHighValInt = device::DeviceAttachmentSpec
|
||||||
::parseOptionalParamAsIntWithSynonyms(
|
::parseOptionalParamAsIntWithSynonyms(
|
||||||
deviceAttachmentSpec->stimBuffApiParams,
|
deviceAttachmentSpec->qualeIfaceApiParams,
|
||||||
ambienceHighValParamNames, 116);
|
ambienceHighValParamNames, 116);
|
||||||
uint32_t ambienceHighVal = static_cast<uint32_t>(ambienceHighValInt);
|
uint32_t ambienceHighVal = static_cast<uint32_t>(ambienceHighValInt);
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user