Difference between revisions of "Adding a computed measurement"

From Senfi Docs
Jump to: navigation, search
(Marked this version for translation)
 
(18 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
=== Pre-requisites ===
+
<translate>
−
* [[Computed_measurement#Design|Design]] your computed measurement
 
  
−
=== Adding a New Computed Measurement ===
+
=== Pre-requisites === <!--T:1-->
 +
A computed measurement requires design and scripting in order for it to work correctly. If this is your first time creating a computed measurement, please read [[Computed_measurement|this guide]] first.
 +
 
 +
<!--T:2-->
 +
You should also be similar with the basic [[Measurement|measurements]] and its concepts. Please read [[Concepts#Measurement.2C_Metric.2C_Tag|this section]] if you require a refresher.
 +
 
 +
<!--T:3-->
 +
You should
 +
* Note down the input measurements.
 +
* Note down the metrics you want to output.
 +
* Decide on a set of tags to use or re-use. Make sure that there is a combination of tags that will uniquely identify the unit/device/equipment that outputs those metrics.
 +
* Have the computed measurement script ready.
 +
* (Optional) Have a set of test data for your computed measurement
 +
 
 +
=== Adding a New Computed Measurement === <!--T:4-->
 +
 
 +
<!--T:5-->
 
# Login to the [https://ems.senfi.io/cms CMS]
 
# Login to the [https://ems.senfi.io/cms CMS]
 
# Go to the '''Computed Measurement''' tab
 
# Go to the '''Computed Measurement''' tab
−
# Click the '''+''' button
+
# Click the '''+''' button to add a new computed measurement.
−
# Fill in the Measurement Name and Measurement Code fields
+
# Give the measurement a descriptive name. This will be shown to users of the dashboard.
−
# Select your Source Measurements
+
# Specify a [[Measurement#Measurement_Code|measurement code]].
−
# Specify the Tags for your computed measurement
+
# Select your Input Measurements
 +
# Add tags.
 +
# Add metrics and specify the type of each metric.
 +
# Write the computed measurement script. See [[Adding_a_computed_measurement#Writing_the_Computed_Measurement_Script|Writing the Computed Measurement Script]] for more details.
 +
# (Optional) Test the computed measurement. See [[Adding_a_computed_measurement#Testing_the_Computed_Measurement|Testing the Computed Measurement]] for more details.
 +
# Save when done.
 +
 
 +
<!--T:6-->
 +
<div class="important">Note: The computed measurement will be instantiated and run immediately upon saving.</div>
 +
 
 +
=== Writing the Computed Measurement Script === <!--T:7-->
 +
 
 +
<!--T:8-->
 +
Fill in the script of your computed measurement in the '''Script''' editor. When you add a new computed measurement, a template script will be pre-filled for you. 
 +
 
 +
<!--T:9-->
 +
# Fill in '''init()''', the initialization function
 +
# Fill in '''compute()''', the computation function
 +
# Declare any global variables, if your script requires them
 +
 
 +
<!--T:10-->
 +
<div class="important">Note: You should not modify the function signatures of the initialization or computation functions.</div>
  
 +
<!--T:11-->
 +
<div class="important">Tip: The script editor will interactively notify you of any syntax errors in your script.</div>
  
−
=== Testing your Computed Measurement ===
+
=== Testing the Computed Measurement === <!--T:12-->
  
 +
<!--T:13-->
 +
# Enter sample measurement data in the '''Testing Value''' editor
 +
# Click the '''TEST''' button
 +
# After 5 seconds, review the test output in the '''Testing Output'''  panel and any console messages in the '''Testing Console''' panel.
  
−
=== Saving your Computed Measurement ===
+
</translate>

Latest revision as of 15:24, 17 October 2019

Pre-requisites

A computed measurement requires design and scripting in order for it to work correctly. If this is your first time creating a computed measurement, please read this guide first.

You should also be similar with the basic measurements and its concepts. Please read this section if you require a refresher.

You should

  • Note down the input measurements.
  • Note down the metrics you want to output.
  • Decide on a set of tags to use or re-use. Make sure that there is a combination of tags that will uniquely identify the unit/device/equipment that outputs those metrics.
  • Have the computed measurement script ready.
  • (Optional) Have a set of test data for your computed measurement

Adding a New Computed Measurement

  1. Login to the CMS
  2. Go to the Computed Measurement tab
  3. Click the + button to add a new computed measurement.
  4. Give the measurement a descriptive name. This will be shown to users of the dashboard.
  5. Specify a measurement code.
  6. Select your Input Measurements
  7. Add tags.
  8. Add metrics and specify the type of each metric.
  9. Write the computed measurement script. See Writing the Computed Measurement Script for more details.
  10. (Optional) Test the computed measurement. See Testing the Computed Measurement for more details.
  11. Save when done.
Note: The computed measurement will be instantiated and run immediately upon saving.

Writing the Computed Measurement Script

Fill in the script of your computed measurement in the Script editor. When you add a new computed measurement, a template script will be pre-filled for you.

  1. Fill in init(), the initialization function
  2. Fill in compute(), the computation function
  3. Declare any global variables, if your script requires them
Note: You should not modify the function signatures of the initialization or computation functions.
Tip: The script editor will interactively notify you of any syntax errors in your script.

Testing the Computed Measurement

  1. Enter sample measurement data in the Testing Value editor
  2. Click the TEST button
  3. After 5 seconds, review the test output in the Testing Output panel and any console messages in the Testing Console panel.
Retrieved from "https://www.senfi.io/docs/index.php?title=Adding_a_computed_measurement&oldid=828"