source.getDICOMFloatsAsArray¶
Use when: You want to read values from the original incoming message before any mapping changes. If you need the modified message during mapping, use message.getDICOMFloatsAsArray.
Signature: source.getDICOMFloatsAsArray(nodePath, instance*)
Returns: Number[] result - the first node as a JS Array of JS Numbers that matches the nodePath and instance
Get the result as an array of floats of the first node that matches the nodePath.
Note
When the optional instance value is specified, the nodePath should not include an instance identifier.
Parameters¶
| Type | Name | Description | Default |
|---|---|---|---|
| String | nodePath | the DICOM node path | |
| Integer | instance* | (optional) the match instance to return. Use 1 for the first instance. | 1 |
Example¶
// Example: Retrieve float values from a DICOM node as a JavaScript array.
// Get an array of floats from the first matching node
var dicomFloats = source.getDICOMFloatsAsArray(
"0010,0030" // DICOM tag
); // e.g. [1.5, 0.0, -1.5, 0.0]
// Get an array of floats from a specific instance (useful for sequences)
var dicomFloatsInstance = source.getDICOMFloatsAsArray(
"0010,0030", // DICOM tag
2 // instance
);