To add a new data point toe CoolPlanetOS, navigate to the "Data Management" page under the "Admin" main menu header.
Select “New Manual Data Point”.
This will open the "Create New Data Point" modal.
Give the data point a name that is relevant to the source of the information.
Select the kind of data point. This classifies the data point into one of three types: Number, Boolean or String, which specifies the type of values within the time series data.
Number - for numeric values such as energy consumption or temperature readings
Boolean - for true/ false values such as on/ off statuses
String - for text-based values - generally reserved for a data point with a limited number of discrete states, e.g. Running, Standby, Off, Error
Select the site where this data will be stored and associated with. This should be the site that the Data Point has originated from.
Select the unit of measurement for the data being inputted from the drop-down. The desired unit can also be searched for in the input window. Examples of units include kWh, kg, Pa, and °C.
Select the Cumulative indicator if your data is increasing in value. It should only be set at true if this is the case. Use this field if you wish to compute the delta or difference between the history points. This will then calculate the actual value consumed for a period. For example, an electricity meter generally records energy consumed as a totalized/ cumulative counter.
Input the value at which your accumulating data resets to zero. Use this field if you know the value at which your meter or data rolls over to zero. This is common on data from old PLCs that had limited bits for stored numeric values.
Select 'Change of Value' for instances where, instead of recording the same value again and again, you would like to only record when the value changes. This is typically used for setpoints and statuses. When interpolating COV data, empty buckets are filled with the previous recorded value.
Enter the 'Remote ID' if known, otherwise the system will autogenerate one.
Finally, click on the “Create Manual Data Point” at the bottom of the modal to create the data point.
Advanced Settings
In some cases, users may need to configure Advanced Settings when creating or editing a Data Point. Toggle the switch to open these options.
Note: If you're unsure whether to configure these options, contact your CPOS administrator for assistance. If left unchanged, the Data Point will be created with default settings.
hisInterval: Defines the time period for recording historical data, ranging from monthly to minutely.
hisInterpolateMode: Determines how missing data is handled.
Auto-Set: The system automatically selects the appropriate mode based on the unit’s quantity, returning 'Default' when the SkySpark hisInterpolate mode is applied.
Apportion: Distributes values proportionally.
COV (Change of Value): Records only significant changes.
Linear: Estimates values using a straight-line progression between known points.
Editing a Data Point
To edit a Data Point, click the desired row to open the 'Data Point Detail' screen. Then, select 'Edit Data Point' from the 'Actions' dropdown menu. This will open the previous modal in edit mode.
Note: 'Kind' and 'Site' are not editable once the Data Point is created.
In edit mode, the options for hisInterpolateMode differ slightly from when creating a Data Point:
Apportion: Distributes values proportionally.
COV: Records only significant changes.
Linear: Estimates values using a straight-line progression.
Default: Applies the SkySpark hisInterpolate mode.