Skip to content

Changelog

Release 4.6

August 2022 - (Release 4.6)

Whats New ?

  • Kelvin API reference documentation is going through a major upgrade in descriptions and key links to Kelvin Documentation for easy terminology reference.
  • Kelvin API now has two swagger.json files to download - one with HTML links and one a plain text version. This is useful for API clients that can not process HTML in descriptions.
  • Kelvin API reference theme and UX overhaul.
  • Kelvin Maps continues to go through major development cycles. Most infographics, terminology and UX is updated to reflect the changes.
  • Carbon Maps is a major new feature documented.
  • Upgraded pipeline and software for the auto-generated file swagger.json following latest standards.
  • Rearranging the Kelvin Overview -> Kelvin Maps structure to give better structure on information of key features.
  • New Security Policy and Certifications that document Kelvin's security conscious approach to management, development and deployment. Also listed CSA Level 1 and SSAE 18 SOC 2 Type II certifications Kelvin has attained.
  • Split GSG Kelvin API section with a sub-menu to allow for separated detailed GSG's for different API functions.
  • Many minor updates including Control Change Infographic speed reduced for easier viewing of the change process

Upgraded Kelvin API Documentation

All API requests listed here have gone through a rigorous upgrade to its documentation on the API description, parameter details, defaults, options and warnings.

  • Asset API

/assets/class/create, /assets/class/list, /assets/class/{asset_class_name}/delete, /assets/class/{asset_class_name}/get, /assets/class/{asset_class_name}/update, /assets/create, /assets/create/upload, /assets/failure-overview/list, /assets/hierarchy/get, /assets/hierarchy/update, /assets/list, /assets/oee/get, /assets/statistics/get, /assets/status/count/get, /assets/status/current/get, /assets/templates/create, /assets/templates/list, /assets/templates/{asset_template_name}/delete, /assets/templates/{asset_template_name}/get, /assets/templates/{asset_template_name}/update, /assets/types/create, /assets/types/list, /assets/types/{asset_type_name}/delete, /assets/types/{asset_type_name}/get, /assets/types/{asset_type_name}/metadata/create, /assets/types/{asset_type_name}/metadata/list, /assets/types/{asset_type_name}/metadata/{asset_type_metadata_name}/delete``/assets/types/{asset_type_name}/metadata/{asset_type_metadata_name}/get, /assets/types/{asset_type_name}/metadata/{asset_type_metadata_name}/update, /assets/types/{asset_type_name}/update, /assets/{asset_name}/datastreams/list, /assets/{asset_name}/delete, /assets/{asset_name}/get, /assets/{asset_name}/hierarchy/get, /assets/{asset_name}/update

  • Metrics API

/metrics/create, /metrics/create/upload, /metrics/list, /metrics/{metric_name}/delete, /metrics/{metric_name}/get, /metrics/{metric_name}/update

  • Control Changes API

/control-changes/create, /control-changes/last/get, /control-changes/list, /control-changes/range/get, /control-changes/sync/{node}/download, /control-changes/sync/{node}/upload, /control-changes/{control_change_id}/get

New Documentation Pages

  • Kelvin Overview -> Security Policy & Certifications page added
  • Kelvin Overview -> Kelvin Maps -> OEE in Kelvin page added
  • Kelvin Overview -> Kelvin Maps -> Carbon Maps page added
  • Getting Started Guides -> GSG Kelvin API -> GSG Kelvin API - Online Reference page added
  • Documentation -> Cloud Server -> Kelvin SDK -> SDK Authentication page added

Updated Documentation Pages

  • Kelvin Overview -> Overview page updated
  • Kelvin Overview -> Recommended Reading page updated
  • Kelvin Overview -> Cloud Server -> Kelvin Assets page updated
  • Kelvin Overview -> Cloud Server -> Kelvin Apps page updated
  • Kelvin Overview -> Cloud Server -> Kelvin Alarms page updated
  • Kelvin Overview -> Cloud Server -> Kelvin Control Change page updated
  • Kelvin Overview -> Kelvin Maps -> Kelvin Maps Overview page updated
  • Kelvin Overview -> Kelvin CoPIlot page updated
  • Getting Started Guides -> GSG Kelvin Manager UI page updated
  • Getting Started Guides -> GSG Kelvin API page updated
  • Getting Started Guides -> GSG Kelvin API -> GSG Kelvin API - Control Change page updated
  • Getting Started Guides -> GSG Kelvin SDK page updated
  • Documentation -> Cloud Server -> Kelvin API -> Kelvin API Overview page updated
  • Documentation -> Cloud Server -> Kelvin Manager UI -> Kelvin Manager UI Overview page updated
  • Documentation -> Cloud Server -> Kelvin Manager UI -> Monitoring -> Alarms Monitoring page updated
  • Documentation -> Cloud Server -> Kelvin Manager UI -> Management -> Metrics -> Metrics page updated
  • Documentation -> Cloud Server -> Kelvin Manager UI -> Management -> Assets -> Assets page updated
  • Documentation -> Cloud Server -> Kelvin SDK -> Kelvin SDK Installation page updated
  • Documentation -> Kelvin Maps -> Kelvin Maps Overview page updated
  • Documentation -> Kelvin Maps -> Kelvin Maps Dashboard page updated
  • Documentation -> Kelvin Maps -> Kelvin Maps Process View page updated
  • Documentation -> Kelvin Maps -> Kelvin Maps Asset Details page updated
  • Documentation -> Kelvin Maps -> Kelvin Maps Process Map Editor page updated
  • Some legacy documentation and tutorials updated for consistent terminology only (content may not be consistent with latest versions of Cloud Server)

New Tutorials

  • New written API tutorial on Create/Edit a Custom Kelvin Template
  • New written API tutorial on Create Kelvin Asset and Kelvin Metric with Kelvin API
  • New written API tutorial on Install and Setup Postman for API Requests
  • New written API tutorial on Create, Read, Delete Kelvin Alarms with Kelvin API
  • Duplicate GSG Kelvin API - Control Change to API tutorial on Create and Monitor a Control Change with Kelvin API

Release 4.6

Kelvin Maps

  • Added Carbon Maps with inefficiency calculations
  • New Data Explorer integrated into Kelvin Maps
  • Added control change & alarm trigger points into Data Explorer
  • Kelvin Maps UX improvements

Kelvin Manager

  • New endpoints rules engine API

Release 4.5 Update 1

July 2022 - Midcycle Release (Release 4.5 / 1)

Whats New ?

  • All references to KICS and KSOS have been removed. It is all now known officially as Kelvin for short and Kelvin Collaborative Control Platform in full.
  • All references to KSDK have been removed. It is now officially known as Kelvin SDK and the Python package is kelvin-sdk with the command line command is kelvin.
  • Added information on Kelvin Failure Detection AI alarm details and analysis tabs in Kelvin Maps.
  • A number of minor improvements to the documentation

Updated Documentation Pages

  • Kelvin Overview -> Overview page updated
  • Kelvin Overview -> Kelvin Maps -> Kelvin Maps Overview page updated
  • Getting Started Guide -> GSG Kelvin SDK page updated
  • Documentation -> Cloud Server -> Kelvin SDK -> Kelvin SDK Installation page updated
  • Documentation -> Cloud Server -> Kelvin SDK -> SDK Authentication legacy page reinstated (temporarily)
  • Documentation -> Kelvin Maps -> Kelvin Maps Asset Details page updated
  • Documentation -> Kelvin Maps -> Kelvin Maps Alarms page updated
  • Legacy documentation pages updated for consistent terminology only (content may not be consistent with latest versions of Cloud Server)

Tutorial New & Updates

  • Updated tutorial for Install Kelvin SDK in MacOS X Catalina (Written)
  • Updated tutorial for Install Kelvin SDK in Windows (Written)
  • Updated tutorial for Install Kelvin SDK in Ubuntu 20.04 (Written)
  • Updated tutorial for From Scratch to MQTT Data Inflow (Written)
  • Legacy tutorial pages updated for consistent terminology only (content may not be consistent with latest versions of Cloud Server)

Release 4.5

Kelvin Maps

  • Added Asset 2D and 3D view with metrics and alarms
  • Added option to upload custom image symbols to the line editor
  • Added Asset Settings page that allows making control changes on the setpoints of an Asset
  • Improved Alarm Detail with list of failure modes and chart view

Kelvin Manager

  • New endpoints on Control Changes API to retrieve historical view of control changes for an asset
  • Removed unnecessary entity types and replaced them with "group" entity type
  • Replaced the hardcoded alarm severity name/title with configurable values.

Release 4.5

June 2022 - (Release 4.5)

Whats New ?

  • Kelvin Maps alarm comments now timestamp the status change for easy historical reference to alarm evolution.
  • Kelvin Maps now support custom Symbols in the Line Editor Symbols Library.
  • Control Change Getting Started Guide now has a new API documented - /control-changes/list. This gives a full list of control change requests and its status on any asset(s).
  • Information and examples for the Control Change Manager has been embedded in many documentation locations for easy quick reference.
  • Kelvin API Reference is now embedded into the documentation. This allows the documentation versioning to also locks the version for the API reference documentation. So v4.5 documentation release references documentation for the v4.5 Kelvin API library (Previously the API reference documentation was only available for the latest version only regardless of documentation version you were looking at)
  • Kelvin API Reference Documentation (swagger.json) is getting refreshed on all comments and descriptions. This major update has started this cycle and will be an on-going process for a number of releases. Check back regularly to see the improved API swagger.json documentation.

New Documentation Pages

  • Kelvin Overview -> Recommended Reading page created
  • Documentation -> Kelvin API -> Kelvin API Reference is now upgraded to be linked to the version releases.

Updated Documentation Pages

  • Kelvin Overview -> Overview page updated
  • Kelvin Overview -> Cloud Server -> Kelvin Nodes page updated
  • Kelvin Overview -> Cloud Server -> Kelvin Bridges page updated
  • Kelvin Overview -> Cloud Server -> Kelvin Control Change page updated
  • Kelvin Overview -> Cloud Server -> Kelvin Assets page updated
  • Kelvin Overview -> Kelvin Maps page updated
  • Kelvin Overview -> Kelvin CoPilot page updated
  • Getting Started Guide -> Getting Started Guide Overview
  • Getting Started Guide -> GSG Guide by Profession page updated
  • Getting Started Guide -> GSG Kelvin API page updated
  • Getting Started Guide -> GSG Kelvin Control Change API page updated
  • Documentation -> Cloud Server -> Kelvin API -> Kelvin API Overview page updated
  • Documentation -> Cloud Server -> Kelvin Manager UI -> Management -> Assets -> Assets page updated
  • Documentation -> Cloud Server -> Kelvin SDK -> Kelvin SDK Overview page updated
  • Documentation -> Kelvin Maps -> Kelvin Maps Alarms page updated
  • Documentation -> Kelvin Maps -> Kelvin Maps Asset Details page updated
  • Documentation -> Kelvin Maps -> Kelvin Maps Line Editor page updated

Tutorial New & Updates

  • Updated tutorial compatibility with Kelvin Versions
  • New written tutorial for Create a New Control Change Request API