XML_Cap_ThermometryBasicParam

XML message about capability of temperature measurement basic parameters

<ThermometryBasicParam version="2.0" xmlns="http://www.isapi.org/ver20/XMLSchema">
  <id><!--req, xs:integer, channel number--></id>
  <enabled opt="true,false"><!--req, xs:boolean, enable or not: false-no, true-yes--></enabled> 
  <streamOverlay opt="true,false"><!--req, xs:boolean, whether displays temperature information on the stream: false-no, true-yes--></streamOverlay>
  <pictureOverlay opt="true,false"><!--req, xs:boolean, whether displays temperature information on the captured picture: false-no, true-yes--></pictureOverlay>
  <temperatureRange opt="-20-150,0-550,0-650,-4-302,32-1022,32-1200,-20-650,-20-1500,automatic,-20-120,20-350,20-45,20-350,30-45,100-550">
    <!--req, xs:string, temperature range-->
  </temperatureRange>
  <temperatureUnit opt="degreeCentigrade,degreeFahrenheit,degreeKelvin">        
    <!--req, xs:string, temperature unit: degreeCentigrade-Celsius(°C), degreeFahrenheit-Fahrenheit(°F), degreeKelvin-Kelvin(K)-->
  </temperatureUnit>
  <temperatureCurve opt="close,transverseTemperatureTrend,longitudinalTemperatureTrend">
    <!--opt, xs:string, temperature curve modes: close-closed, transverseTemperatureTrend-transverse temperature mode, longitudinalTemperatureTrend-longitudinal temperature mode-->
  </temperatureCurve>
  <fireImageMode opt="blackWhite,thermalProbe,fireGround"> 
    <!--opt, xs:string, fire detection modes: blackWhite-black and white mode, thermalProbe-thermal detection mode, fireGroud-fire scene mode-->
  </fireImageMode>	
  <emissivity min="0.01" max="1.00" default="0.96">
    <!--opt, xs:float, the emissivity is between 0.01 and 1.00, which corrects to two decimal places. This parameter is used by the device (i.e., DS-2TF03-260V/GLT, DS-2TF03-167V/GLT) that does not support regular frame and preset-->
  </emissivity>
  <distanceUnit opt="meter,feet,centimeter">  
    <!--req, xs:string-->
  </distanceUnit>
  <TemperatureColor>
    <!--opt, set the alarm information color for the temperature measurement-->
    <type opt="highTemperature,lowTemperature,rangeTemperature,heatPreservation">
      <!--req ,xs:string, set temperature alarm types: highTemperature field-high temperature alarm, when the measured temperature is higher than the configured value of highTemperature field, the measured temperature will be marked by color; lowTemperature-low temperature alarm, when the measured temperature is lower than the configured value of lowTemperature field, the measured temperature will be marked by color; rangeTemperature-range temperature alarm, when the measured temperature is between the configured values of highTemperature field and lowTemperature field, the measured temperature will be marked by color; heatPreservation-insulation alarm, when the measured temperature is not between the configured values of highTemperature field and lowTemperature field, the measured temperature will be marked by color-->
    </type>
    <highTemperature min="-273" max="10000"><!--dep, xs:integer--></highTemperature>
    <lowTemperature min="-273" max="10000"><!--dep, xs:integer--></lowTemperature>
  </TemperatureColor>
  <enviroTemperature min="-273" max="10000"><!--opt, xs:integer, environment temperature, unit: °C--></enviroTemperature>
  <enviroHumidity min="0" max="100"><!--opt, xs:integer, environment humidity, unit:%--></enviroHumidity>
  <correctionVolume min="-100" max="100" def="0"><!--opt, xs:integer, temperature correction--></correctionVolume>
  <specialPointThermType opt="centerPoint,highestPoint,lowestPoint">
    <!--req, xs:string, display the special point temperature, central point temperature, highest temperature, lowest temperature. Supports multiple selections-->
  </specialPointThermType>
  <distance min="0" max="50"><!--req, xs:integer; unit:m, the distance range is [0, 10000]--></distance>
  <reflectiveEnable><!--req, xs:boolean, whether enables temperature reflection--></reflectiveEnable>
  <reflectiveTemperature min="" max=""><!--opt, xs:float, reflective temperature, which corrects to one decimal place--></reflectiveTemperature>
  <alert min="-73.3" max="1000.0"><!--opt, xs: float, pre-alarm threshold--></alert>
  <alarm min="-73.3" max="1000.0"><!--opt, xs: float, alarm threshold--></alarm>
  <showTempStripEnable><!--opt, xs:boolean, whether enables displaying temperature bar--></showTempStripEnable>
  <thermalOpticalTransmittance min="0.001" max="1.000" def="1.000">
    <!--opt, xs: float, optical transmissivity is between 0.001 and 1.000, which corrects to three decimal places. The default value is 1.000-->
  </thermalOpticalTransmittance>
  <externalOpticsWindowCorrection min="-40.0" max="80.0" def="20.0">
    <!--opt, xs: float, external optical temperature is between -40.0 °C and 80.0 °C. The default value is 20 °C-->
  </externalOpticsWindowCorrection>
  <isSupportAlertOutputIOPortList><!--opt, xs:boolean, "true", true indicates support, no return indicates not support--></isSupportAlertOutputIOPortList>
  <isSupportAlarmOutputIOPortList><!--opt, xs:boolean, "true", true indicates support, no return indicates not support--></isSupportAlarmOutputIOPortList>
  <alertFilteringTime min="0" max="200" default="0"><!--opt, xs:integer, temperature pre-alarm dwell time, unit:s--></alertFilteringTime>
  <alarmFilteringTime min="0" max="200" default="0"><!--opt, xs:integer, temperature alarm dwell time, unit:s--></alarmFilteringTime>
  <displayMaxTemperatureEnabled opt="true,false"><!--opt, xs:boolean, whether displays the maximum temperature--></displayMaxTemperatureEnabled>
  <displayMinTemperatureEnabled opt="true,false"><!--opt, xs:boolean, whether displays the minimum temperature--></displayMinTemperatureEnabled>
  <displayAverageTemperatureEnabled opt="true,false"><!--opt, xs:boolean, whether displays the average temperature--></displayAverageTemperatureEnabled>
  <thermometryInfoDisplayposition opt="rules_around,top_left_of_screen">
    <!--opt, xs:string, position of temperature measurement information overlay-->
  </thermometryInfoDisplayposition>
  <calibrationCoefficientEnabled opt="true,false"><!--opt, xs:boolean, whether enables calibration coefficient--></calibrationCoefficientEnabled>
  <calibrationCoefficient min="0.00" max="30.00"><!--dep, xs:float, calibration coefficient, ranges from 0 to 30, corrects to two decimal places--></calibrationCoefficient>
  <emissivityMode opt="rougher,rough,smooth,smoother,customsettings">
    <!--opt,xs:string, emissivity type: "rougher"-rougher 0.95, "rough"-rough 0.80, "smooth"-smooth 0.60, "smoother"-smoother 0.30, "customsettings"-customized value, ranges from 0.01 to 1.00, the larger the value, the higher the roughness-->
  </emissivityMode>
  <displayTemperatureInOpticalChannelEnabled opt="true,false">
    <!--opt,xs:boolean, display the temperature information of optical channel-->
  </displayTemperatureInOpticalChannelEnabled>
  <distanceMode opt="selfAdapt,fixed"><!--optional, xs:string, distance mode: "selfAdapt"-self-adaption, "fixed"-fixed distance--></distanceMode>
  <faceTemperatureInfoUploadEnabled opt="true,false"><!--optional, xs:boolean, whether to enable uploading face temperature information: true-enable, false-disable--></faceTemperatureInfoUploadEnabled>
  <calibrationFileVersion><!--optional, xs:string, read-only, calibration file version information--></calibrationFileVersion>
  <alarmInterval min="1" max="300"><!--optional, xs:integer, temperature measurement interval, unit: second--></alarmInterval>
  <rulesOverlayMode opt="all,alarm"><!--optional, xs:string, rule overlay mode: all (all rules), alarm (triggered alarm rule)--></rulesOverlayMode>
  <toleranceTemperature min="1" max="5"><!--optional, xs:float, tolerance temperature, value range: [1,5], unit: Celsius--></toleranceTemperature>
  <alarmMode opt="temperatureIntervalMeasurement,alarm_alert"><!--optional, xs:string, alarm mode: "temperatureIntervalMeasurement" (temperature range measurement), "alarm_alert" (pre-alarm/alarm)--></alarmMode>
  <NormalRulesColor><!--optional, normal rule color; this node is valid when the value of alarmMode is "temperatureIntervalMeasurement"-->
    <R><!--required, xs:integer--></R>
    <G><!--required, xs:integer--></G>
    <B><!--required, xs:integer--></B>
  </NormalRulesColor>
  <NormalTemperatureIntervalMeasurement><!--optional, normal temperature range measurement-->
    <alarmType opt="highestTemp,lowestTemp"><!--optional, xs:string, alarm type: "highestTemp" (the highest temperature), "lowestTemp" (the lowest temperature)--></alarmType>
    <TemperatureIntervalList size="4"><!--optional, temperature range list; up to 4 temperature ranges are allowed-->
      <TemperatureInterval>
        <id min="1" max="4"><!--optional, xs:integer, No.--></id>
        <enabled opt="true,false"><!--optional, xs:boolean, whether to enable--></enabled>
        <name min="" max=""><!--optional, xs:string, range name--></name>
        <minTemperature min="" max=""><!--optional, xs:float, the lowest temperature; value range: [-20,550], unit: Celsius; the value should be accurate to one decimal place--></minTemperature>
        <maxTemperature min="" max=""><!--optional, xs:float, the highest temperature; value range: [-20,550], unit: Celsius; the value should be accurate to one decimal place--></maxTemperature>
        <AlarmColor><!--optional, alarm color of temperature range-->
          <R><!--required, xs:integer--></R>
          <G><!--required, xs:integer--></G>
          <B><!--required, xs:integer--></B>
        </AlarmColor>
        <AlarmOutputIOPortList size=""><!--optional, alarm output port list-->
          <OutputIOPort><!--list-->
            <portID min="" max=""><!--required, xs:string, port No.--></portID>
            <enabled opt="true,false"><!--required, xs:boolean, whether to enable--></enabled>
          </OutputIOPort>
        </AlarmOutputIOPortList>
      </TemperatureInterval>
    </TemperatureIntervalList>
  </NormalTemperatureIntervalMeasurement>
  <SunReflectionBlur>
    <!--optional, object, reflect light filter-->
    <enabled opt="true,false">
      <!--required, boolean, whether to enable reflect light filter-->true
    </enabled>
    <sensitivity min="1" max="100">
      <!--optional, int, sensitivity of reflect light filter; value range: [1,100]-->50
    </sensitivity>
  </SunReflectionBlur>
  <VehicleBlur>
    <!--optional, object, forklift filter-->
    <enabled opt="true,false">
      <!--required, boolean, whether to enable forklift filter-->true
    </enabled>
    <sensitiveLevel min="0" max="4">
      <!--optional, int, sensitivity of forklift filter; value range: [0,4]-->4
    </sensitiveLevel>
  </VehicleBlur>
  <TemperatureSuddenChange>
    <!--optional, object, configurations of temperature sudden change alarm  under normal thermometry mode-->
    <mode opt="close,temperatureSuddenIncrease,temperatureSuddenDecrease">
      <!--required, string, temperature sudden change mode: "close" (disabled), "temperatureSuddenIncrease" (temperature sudden increase), "temperatureSuddenDecrease" (temperature sudden decrease)-->temperatureSuddenIncrease
    </mode>
    <alarm min="0" max="570">
      <!--optional, float, alarm threshold, value range: [0,570]; the value is accurate to one decimal place-->0.0
    </alarm>
    <cycleCfg min="5" max="3600">
      <!--optional, int, recording cycle, value range: [5,3600]-->60
    </cycleCfg>
  </TemperatureSuddenChange>
</ThermometryBasicParam>

Remarks

  • The reflect light filter, forklift filter and VCA function are mutually exclusive.

  • The following nodes are not supported by the thermographic automation thermal camera (DS-2TA03-15SVI, DS2TA06-25SVI): <TemperatureColor>, <specialPointThermType>, and <reflectiveEnable>.