Defines SignNet module, i.e., SignNet configuration and loading.
- Note
- SW Release Applicability: These APIs are available in NVIDIA DRIVE Software releases.
|
enum | dwSignNetBatchSize {
DW_SIGNNET_BATCH_SIZE_1 = 0,
DW_SIGNNET_BATCH_SIZE_16 = 1,
DW_SIGNNET_BATCH_SIZE_32 = 2
} |
| SignNet network batch size options. More...
|
|
enum | dwSignNetModel {
DW_SIGNNET_MODEL_US_V2 = 0,
DW_SIGNNET_MODEL_US_V4 = 1,
DW_SIGNNET_MODEL_EU_V3 = 2,
DW_SIGNNET_MODEL_EU_V4 = 3,
DW_SIGNNET_MODEL_JP_V1 = 4,
DW_SIGNNET_MODEL_COUNT,
DW_SIGNNET_MODEL_US_CURRENT = DW_SIGNNET_MODEL_US_V4,
DW_SIGNNET_MODEL_EU_CURRENT = DW_SIGNNET_MODEL_EU_V4,
DW_SIGNNET_MODEL_JP_CURRENT = DW_SIGNNET_MODEL_JP_V1,
DW_SIGNNET_MODEL_CUSTOM = -1
} |
| SignNet network models to be loaded by SignNet module. More...
|
|
|
DW_API_PUBLIC dwStatus | dwSignNet_getAvailableClasses (const dwSignClass **signClasses, uint32_t *numSignClasses, dwSignNetHandle_t obj) |
| Returns the sign classes that SignNet can detect. More...
|
|
DW_API_PUBLIC dwStatus | dwSignNet_getAvailableClassesNew (dwSignNetClassName *signClasses, uint32_t *numSignClasses, dwSignNetHandle_t obj) |
| Returns the sign classes that SignNet can detect. More...
|
|
DW_API_PUBLIC dwStatus | dwSignNet_getAvailableModels (dwSignNetModelName *availableModels, uint32_t *numAvailableModels) |
| Returns the list of models the SignNet module has. More...
|
|
DW_API_PUBLIC dwStatus | dwSignNet_getClassLabel (const char **classLabel, uint32_t classIdx, dwSignNetHandle_t obj) |
| Returns the class label for a given class index for UI output. More...
|
|
DW_API_PUBLIC dwStatus | dwSignNet_getDNNMetaData (dwDNNMetaData *metaData, dwSignNetHandle_t obj) |
| Returns the DNN metadata. More...
|
|
DW_API_PUBLIC dwStatus | dwSignNet_getInputBlobsize (dwBlobSize *inputBlobsize, dwSignNetHandle_t obj) |
| Returns input blob size that SignNet expects. More...
|
|
DW_API_PUBLIC dwStatus | dwSignNet_getModelNameLabel (const char **modelNameLabel, dwSignNetHandle_t obj) |
| Returns the SignNet model text label (name of a model) for a hangle. More...
|
|
DW_API_PUBLIC dwStatus | dwSignNet_getNumberOutputs (uint32_t *numSignOutputs, dwSignNetHandle_t obj) |
| Returns the number of raw signnet outputs its DNN produces. More...
|
|
DW_API_PUBLIC dwStatus | dwSignNet_getTrafficSignalClass (dwTrafficSignalClass *trafficSignalClass, uint32_t classIdx, dwSignNetHandle_t obj) |
| Returns the dwTrafficSignalClass sturcutre for a given class index for UI output. More...
|
|
DW_API_PUBLIC dwStatus | dwSignNet_getTypeLabel (const char **classLabel, uint32_t classIdx, dwSignNetHandle_t obj) |
| Returns the class label for a given class index for UI output. More...
|
|
DW_API_PUBLIC dwStatus | dwSignNet_initDefaultParams (dwSignNetParams *params, dwContextHandle_t ctx) |
| Initializes SignNet parameters with default values. More...
|
|
DW_API_PUBLIC dwStatus | dwSignNet_initialize (dwSignNetHandle_t *signNetHandle, const dwSignNetParams *signNetParams, dwContextHandle_t ctx) |
| Initializes SignNet module. More...
|
|
DW_API_PUBLIC dwStatus | dwSignNet_release (dwSignNetHandle_t obj) |
| Releases the SignNet module. More...
|
|
DW_API_PUBLIC dwStatus | dwSignNet_reset (dwSignNetHandle_t obj) |
| Resets SignNet. More...
|
|
◆ dwSignNetParams
Data Fields |
dwSignNetBatchSize |
batchSize |
SignNet network batch size. Default is DW_SIGNNET_BATCH_SIZE_1. |
const void * |
networkCustomData |
Custom network data. Must be set if custom model is selected and available. |
dwSignNetModel |
networkModel |
SignNet network model. Default is DW_SIGNNET_MODEL_FRONT_US_V2. |
dwPrecision |
networkPrecision |
SignNet network precision. Default is DW_PRECISION_FP32. |
◆ DW_SIGNNET_MAX_CLASSES
#define DW_SIGNNET_MAX_CLASSES 796 |
◆ DW_SIGNNET_MAX_DNN_OUTPUT
#define DW_SIGNNET_MAX_DNN_OUTPUT 1000 |
◆ DW_SIGNNET_MAX_MODELS
#define DW_SIGNNET_MAX_MODELS 64 |
◆ dwSignNetClassName
Type for SignNet model class.
Definition at line 115 of file SignNet.h.
◆ dwSignNetHandle_t
Handle to a SignNet object.
Definition at line 68 of file SignNet.h.
◆ dwSignNetModelName
SignNet model name type.
Definition at line 112 of file SignNet.h.
◆ dwSignNetBatchSize
SignNet network batch size options.
Enumerator |
---|
DW_SIGNNET_BATCH_SIZE_1 | SignNet network is loaded with batch size = 1 if available.
|
DW_SIGNNET_BATCH_SIZE_16 | SignNet network is loaded with batch size = 16 if available.
|
DW_SIGNNET_BATCH_SIZE_32 | SignNet network is loaded with batch size = 32 if available.
|
Definition at line 93 of file SignNet.h.
◆ dwSignNetModel
SignNet network models to be loaded by SignNet module.
Enumerator |
---|
DW_SIGNNET_MODEL_US_V2 | [Deprecated] Non-HWISP SignNet model for US signs, version 2
|
DW_SIGNNET_MODEL_US_V4 | HWISP SignNet model for US signs, version 4.
|
DW_SIGNNET_MODEL_EU_V3 | [Deprecated] Non-HWISP SignNet model for EU signs, version 3
|
DW_SIGNNET_MODEL_EU_V4 | HWISP SignNet model for EU signs version 4.
|
DW_SIGNNET_MODEL_JP_V1 | SignNet model for Japan signs version 1.
|
DW_SIGNNET_MODEL_COUNT | |
DW_SIGNNET_MODEL_US_CURRENT | Current models for use per country.
|
DW_SIGNNET_MODEL_EU_CURRENT | |
DW_SIGNNET_MODEL_JP_CURRENT | |
DW_SIGNNET_MODEL_CUSTOM | Loads custom SignNet model if available.
Network name must be provided in networkCustomData field in dwSignNetParams
|
Definition at line 71 of file SignNet.h.
◆ dwSignNet_getAvailableClasses()
Returns the sign classes that SignNet can detect.
- Parameters
-
[out] | signClasses | A pointer to list of object classes that SignNet can detect. |
[out] | numSignClasses | Number of object classes. |
[in] | obj | Specifies the SignNet handle. |
- Returns
- DW_SUCCESS
DW_INVALID_HANDLE - If the given handle is invalid,i.e. null or of wrong type
DW_BAD_CAST
DW_INVALID_ARGUMENT
- Deprecated:
- Use dwSignNet_getAvailableClassesNew() in this release. In future releases, use same dwSignNet_getAvailableClasses() but with new signature.
◆ dwSignNet_getAvailableClassesNew()
Returns the sign classes that SignNet can detect.
- Parameters
-
[out] | signClasses | A pointer to list of class name that SignNet can detect. |
[out] | numSignClasses | Number of object classes. |
[in] | obj | Specifies the SignNet handle. |
- Returns
- DW_SUCCESS
DW_INVALID_HANDLE - If the given handle is invalid,i.e. null or of wrong type
DW_BAD_CAST
DW_INVALID_ARGUMENT
◆ dwSignNet_getAvailableModels()
Returns the list of models the SignNet module has.
- Parameters
-
[out] | availableModels | A pointer to a list of names of models that SignNet model has. |
[out] | numAvailableModels | Number of models. |
- Returns
- DW_SUCCESS, DW_INVALID_HANDLE, DW_BAD_CAST, DW_INVALID_ARGUMENT
◆ dwSignNet_getClassLabel()
Returns the class label for a given class index for UI output.
- Parameters
-
[out] | classLabel | Pointer to class label. |
[in] | classIdx | Class index within the model being used. |
[in] | obj | The handle to SignNet. |
- Returns
- DW_SUCCESS, DW_INVALID_ARGUMENT
◆ dwSignNet_getDNNMetaData()
Returns the DNN metadata.
- Parameters
-
[out] | metaData | Pointer to metaData struct. |
[in] | obj | The handle to SignNet. |
- Returns
- DW_SUCCESS
DW_INVALID_ARGUMENT : if metaData pointer is Null
DW_INVALID_HANDLE : if signNet handle is invalid i.e Null or wrong type
◆ dwSignNet_getInputBlobsize()
Returns input blob size that SignNet expects.
- Parameters
-
[out] | inputBlobsize | Input blob size. |
[in] | obj | Specifies the SignNet handle. |
- Returns
- DW_SUCCESS
DW_INVALID_ARGUMENT : if inputBlobsize pointer is Null
DW_INVALID_HANDLE : if signNet handle is invalid i.e Null or wrong type
◆ dwSignNet_getModelNameLabel()
Returns the SignNet model text label (name of a model) for a hangle.
- Parameters
-
[out] | modelNameLabel | Pointer to model name label. |
[in] | obj | The handle to SignNet. |
- Returns
- DW_SUCCESS, DW_INVALID_ARGUMENT
◆ dwSignNet_getNumberOutputs()
Returns the number of raw signnet outputs its DNN produces.
- Parameters
-
[out] | numSignOutputs | Number of object classes. |
[in] | obj | Specifies the SignNet handle. |
- Returns
- DW_SUCCESS, DW_INVALID_HANDLE, DW_BAD_CAST, DW_INVALID_ARGUMENT
◆ dwSignNet_getTrafficSignalClass()
Returns the dwTrafficSignalClass sturcutre for a given class index for UI output.
- Parameters
-
[out] | trafficSignalClass | Pointer to dwTrafficSignalClass structure to populate. |
[in] | classIdx | Class index within the model being used. |
[in] | obj | The handle to SignNet. |
- Returns
- DW_SUCCESS, DW_INVALID_ARGUMENT
◆ dwSignNet_getTypeLabel()
Returns the class label for a given class index for UI output.
- Parameters
-
[out] | classLabel | Pointer to class label. |
[in] | classIdx | Class index within the model being used. |
[in] | obj | The handle to SignNet. |
- Returns
- DW_SUCCESS, DW_INVALID_ARGUMENT
- Deprecated:
- Will be removed. please use
dwSignNet_getClassLabel()
◆ dwSignNet_initDefaultParams()
Initializes SignNet parameters with default values.
- Parameters
-
[out] | params | SignNet default parameters. |
[in] | ctx | The handle to the context. |
- Returns
- DW_SUCCESS
DW_INVALID_ARGUMENT : if param pointer is Null
- Note
- Default precision depends on the current GPU.
◆ dwSignNet_initialize()
Initializes SignNet module.
- Parameters
-
[out] | signNetHandle | A pointer to SignNet handle to be initialized. |
[in] | signNetParams | SignNet parameters |
[in] | ctx | The handle to the context. |
- Returns
- DW_SUCCESS
DW_INVALID_ARGUMENT : if signNetParams pointer is Null
DW_INVALID_HANDLE : if signNet handle ctx is invalid i.e Null or wrong type
- Note
- If SignNet module is to be loaded on a non-default GPU Device, the initialization must take place after
dwContext_selectGPUDevice
.
◆ dwSignNet_release()
Releases the SignNet module.
- Parameters
-
[in] | obj | The handle to SignNet. |
- Returns
- DW_SUCCESS
DW_INVALID_HANDLE : if signNet handle is invalid i.e Null or wrong type
- Note
- This method renders the handle unusable.
◆ dwSignNet_reset()
Resets SignNet.
- Parameters
-
[in] | obj | Handle to SignNet. |
- Returns
- DW_SUCCESS
DW_INVALID_HANDLE : if signNet handle is invalid, i.e NULL or wrong type