PAR Sensor Calibration

adjusts the MultispeQ PAR sensor values (without changing the color balance) using a known “universal” PAR level and darkness.

When using the CaliQ for calibrating the PAR sensor, make sure it is connected and communicating before starting the calibration procedure. To check if it is properly connected, go to Instrument Settings and test the connection.

Warning

This calibration requires a CaliQ device

ID: 2225

Basic Usage

Example: Import statement for the par_sensor_calibration protocol
## Import par_sensor_calibration
from jii_multispeq_protocols.protocols.calibrations import par_sensor_calibration as _par_sensor_calibration

Sequence

        %%{
init: {
  "theme": "base",
  "themeVariables": {"primaryColor": "#49e06d", "primaryTextColor": "#005e5e", "primaryBorderColor": "#005e5e", "lineColor": "#fff381", "secondaryColor": "#afd7f4", "tertiaryColor": "#D7EBF9"}
}
}%%
flowchart TD
     START((Start))
     A0["`**Protocol**`"]:::protocol
     START ==> A0
     A1["`**Protocol**`"]:::protocol
     A0 ==> A1
     A2["`**Protocol**`"]:::protocol
     A1 ==> A2
     A3["`**Protocol**`"]:::protocol
     A2 ==> A3
     A4["`**Protocol**`"]:::protocol
     A3 ==> A4
     A5["`**pre_qlight_to_qpar**
*Repeats*: 10`"]:::protocol
     A4 ==> A5
     A6["`**qlight_to_qpar**
*Repeats*: 10`"]:::protocol
     A5 ==> A6
     A7["`**Protocol**`"]:::protocol
     A6 ==> A7
     A8["`**light**
*Repeats*: 10
*Sensor:* PAR light sensor`"]:::protocol
     A7 ==> A8
     A9["`**dark**
*Repeats*: 5
*Sensor:* PAR light sensor`"]:::protocol
     A8 ==> A9
     A9 ==> END
     END(( End ))
     classDef protocol text-align:left,white-space:pre;
    

Details

Code

Protocol Code
[  {  '_protocol_set_': [  {  'alert': 'Connect the CaliQ USB-C cable to the '
                                       'MultispeQ. Be sure to get the correct '
                                       'orientation.',
                              'check_battery': 1},
                           {  'set_par': [  0.3618,
                                            -0.2348,
                                            -0.1362,
                                            -0.0105,
                                            6.7386]},
                           {'par_tweak': 1, 'set_par_dark': 0},
                           {  'alert': 'Clip CaliQ Light Source and CaliQ PAR '
                                       'Sensor together.',
                              'protocols_pre_delay': 1000},
                           {'qlight': [1, 100]},
                           {  'label': 'pre_qlight_to_qpar',
                              'protocol_repeats': 10,
                              'qpar': [1]},
                           {  'label': 'qlight_to_qpar',
                              'protocol_repeats': 10,
                              'qpar': [1]},
                           {  'alert': 'Place CaliQ Light Source on the '
                                       'MultispeQ PAR sensor. Make sure there '
                                       'is no visible gap. (LED light should '
                                       'be on)',
                              'par_tweak': 1},
                           {  'environmental': [['light_intensity']],
                              'label': 'light',
                              'protocol_repeats': 10},
                           {  'environmental': [['light_intensity']],
                              'label': 'dark',
                              'protocol_repeats': 5,
                              'qlight': [1, 0]}],
      'require_firmware': [2, 100.4]}]

Analysis

Usage

Analysis Example (requires JII-MultispeQ package)
from jii_multispeq import measurement as _measurement
from jii_multispeq_protocols.protocols.calibrations import par_sensor_calibration as _par_sensor_calibration

## Take a measurement using the MultispeQ
data, crc32 = _measurement.measure(port="<Selected Port>", protocol=_par_sensor_calibration, filename=None, notes="")

## The analyze function of JII-MultispeQ helps to provide the correct format
output = _measurement.analyze( data, _par_sensor_calibration._analyze )

## View Analysis output (as table)
_measurement.view( output )

Function Details

_analyze(_data)[source]
  • Macro for data evaluation on PhotosynQ.org

  • by: David M. Kramer

  • created: April 3, 2019 2:41 PM

Example Data

Parameter

Value

device_battery

8

device_firmware

2.21

device_id

ff:ff:ff:ff

device_name

MultispeQ

device_version

2

error

Battery level too low for calibration! Please recharge until at least 50%!

time

1564325628723