The Virtual Sensor API is used to detect faults in a variable of importance. This could be for instance to detect overheating in electrical assets or to detect thermal anomalies in HVAC process. It leverages supervised machine learning techniques to learn the relationship between the target variable, a set of heterogeneous available variables, and to identify drift between the predicted value of the target and its actual variable. This API should be used when the target variable is supposed to have an underlying pattern and when measurements of the target variable are always available. This document provides a general tutorial for users who want to consume the Virtual Sensor Fault Detection API.
- The Virtual Sensor Fault Detection API includes 4 features:
- Learn the model (the relationship between the input data and the target on which to detect faults). It requires data with measurement of the target. (createModel endpoint). - Detect fault by comparing the target variable value and its estimated value by the model. It requires the model ID of the corresponding model and the measured value of the target (applyModelAndDetectFaults endpoint). - Update an existing model by feeding it with new data (updateModel endpoint). - Get information on an existing model (getModelInformation endpoint).
Take the tour and experiment on your own data prior to any development through our hands-on application !\r\n\r\nhttps://urldefense.com/v3/__https://try-analytics-se.azurewebsites.net/vsfd__;!!GF_29dbcQIUBPA!gOmWZKxCOwy-V41NzIYvALqxexBuKHokVmaA7_otnXU9tY6UuNjA590JS1d-5gIsIbU$ [try-analytics-se[.]azurewebsites[.]net]
The createModel
endpoint creates a virtual sensor model. The created virtual sensor model uses information available from driver measurements and process parameters to model the relationship between the drivers and the target.
The principle of this service is the following:
- Historical training data depicting how a system works is available. - A target variable, i.e., data of special importance for which we want to build a virtual sensor model, is known. - Some pattern in the data is suspected, i.e. some relationship between some of the available data and the target can be observed. - This pattern can be used to create a virtual sensor model to generate predictions.
The model can be later on applied to predict the target. Comparing the real measurements to the predicted target, we can identify drift from normal behavior.
The applyModelAndDetectFaults
endpoint applies the model over test data containing the target variable, and uses the result as a reference to detect anomalies in the input signal.
The updateModel
endpoint updates the model created with the createModel service. The input data should be the same variables as the ones used to create the initial model.
This service returns information on an existing prediction model that is securely stored on the Schneider-Electric platform.
Amount of calls to the API in the SANDBOX are limited. To get a full experience and extend the thresholds, please subscribe to the API and use the production environment.
Run in Postman collection
First, you need to download the free Postman application for your operating system. Postman currently supports Mac, Windows, and Linux. Once you have Postman installed, you can import the Forecasting API Postman collection by clicking the orange “Run in Postman” button. At this point, you should see the Forecasting API folder in the left-hand column under the Collections tab.
Step 1: Setup environment Step 2: Prepare Data Step 3: Create a new energy model Step 4: Train model Step 5: Apply an existing forecasting model to new data Step 6: Get model information on an existing prediction model
This API uses API keys to authenticate and allow access to the API. Your API keys carry many privileges, so be sure to keep them secure! The API key should be included in all API requests in the Authorization header that looks like the following: | Authorization: your_subscription_key For steps on how to generate your_subscription_key please refer to the Features tab.
We follow the error response format proposed in RFC 7807 known as Problem Details for HTTP APIs. As with our normal API responses, your client must be prepared to gracefully handle additional members of the response.
HTTP Status Code |
Error Reason |
---|---|
400Bad request |
Your request could not be processed. This is a generic error. InvalidAction The action requested was not valid for this resource. This error is returned when you try to access an action that doesn't exist. For example, /campaigns/{id}/actions/send. InvalidResource The resource submitted could not be validated. For field-specific details, see field_warnings or field_errors objects. This error means that the object submitted to a POST or PATCH request failed to validate against JSON schema, and could relate to campaign, interest group, merge field, or any other available object. JSONParseError We encountered an unspecified JSON parsing error. This error means that your JSON was formatted incorrectly or was considered invalid or incomplete. |
401APIKeyMissing |
Your request did not include an API key. This error suggests that your API key was missing from your request, or that something was formatted or named improperly in your header. To learn more, check out Get Started with the Mailchimp API. Your API key may be invalid, or you've attempted to access the wrong data center. Check that your API key was input correctly, and verify which data center to access. To learn more, check out Get Started with the Mailchimp API. |
403Forbidden |
You are not permitted to access this resource. This is a generic error. UserDisabled - This account has been disabled. The Mailchimp account is deactivated. Contact our support team if you need more help. WrongDatacenter - The API key provided is linked to a different data center. This error suggests that you tried to contact the wrong data center. It's often associated with misconfigured libraries. |
404ResourceNotFound |
The requested resource could not be found.This error tells you a specific resource doesn't exist. It's possible that the resource has been moved or deleted, or that there's a typo in your request. |
405MethodNotAllowed |
The requested method and resource are not compatible. See the Allow header for this resource's available methods. This error means that the requested resource does not support the HTTP method you used. Find out which methods are allowed for each resource in the API Reference. |
414ResourceNestingTooDeep |
The sub-resource requested is nested too deeply. This uncommon error appears if you've tried to generate a URL with too many resources. |
422InvalidMethodOverride |
You can only use the X-HTTP-Method-Override header with the POST method. This error lets you know you've tried to override an incompatible method. The Mailchimp API only permits method override with POST. RequestedFieldsInvalid - The fields requested from this resource are invalid. This error suggests there is a typo in your field request or some other type of syntax error or problem that invalidates your request. |
429TooManyRequests |
You have exceeded the limit of 10 simultaneous connections. When you reach the connection limit, we'll throttle server response. If any of your requests time out after you've reached the limit, those requests could still be considered open and continue to slow your connection. Contact the Exchange support team at exchange.support@se.com if you think this is the case. |
500InternalServerError |
An unexpected internal error has occurred. Please contact Support for more information. This error lets you know our servers have experienced a problem. Although this is rare, please contact exchange.support@se.com to let us know that you've encountered this error. |
503ComplianceRelated |
This method has been disabled. |
400 Bad request |
---|
Your request could not be processed. This is a generic error. InvalidAction The action requested was not valid for this resource. This error is returned when you try to access an action that doesn't exist. For example, /campaigns/{id}/actions/send. InvalidResource The resource submitted could not be validated. For field-specific details, see field_warnings or field_errors objects. This error means that the object submitted to a POST or PATCH request failed to validate against JSON schema, and could relate to campaign, interest group, merge field, or any other available object. JSONParseError We encountered an unspecified JSON parsing error. This error means that your JSON was formatted incorrectly or was considered invalid or incomplete. |
401 APIKeyMissing |
---|
Your request did not include an API key. This error suggests that your API key was missing from your request, or that something was formatted or named improperly in your header. To learn more, check out Get Started with the Mailchimp API. Your API key may be invalid, or you've attempted to access the wrong data center. Check that your API key was input correctly, and verify which data center to access. To learn more, check out Get Started with the Mailchimp API. |
403 Forbidden |
---|
You are not permitted to access this resource. This is a generic error. UserDisabled - This account has been disabled. The Mailchimp account is deactivated. Contact our support team if you need more help. WrongDatacenter - The API key provided is linked to a different data center. This error suggests that you tried to contact the wrong data center. It's often associated with misconfigured libraries. |
404 ResourceNotFound |
---|
The requested resource could not be found.This error tells you a specific resource doesn't exist. It's possible that the resource has been moved or deleted, or that there's a typo in your request. |
405 MethodNotAllowed |
---|
The requested method and resource are not compatible. See the Allow header for this resource's available methods. This error means that the requested resource does not support the HTTP method you used. Find out which methods are allowed for each resource in the API Reference. |
414 ResourceNestingTooDeep |
---|
The sub-resource requested is nested too deeply. This uncommon error appears if you've tried to generate a URL with too many resources. |
422 InvalidMethodOverride |
---|
You can only use the X-HTTP-Method-Override header with the POST method. This error lets you know you've tried to override an incompatible method. The Mailchimp API only permits method override with POST. RequestedFieldsInvalid - The fields requested from this resource are invalid. This error suggests there is a typo in your field request or some other type of syntax error or problem that invalidates your request. |
429 TooManyRequests |
---|
You have exceeded the limit of 10 simultaneous connections. When you reach the connection limit, we'll throttle server response. If any of your requests time out after you've reached the limit, those requests could still be considered open and continue to slow your connection. Contact the Exchange support team at exchange.support@se.com if you think this is the case. |
500 InternalServerError |
---|
An unexpected internal error has occurred. Please contact Support for more information. This error lets you know our servers have experienced a problem. Although this is rare, please contact exchange.support@se.com to let us know that you've encountered this error. |
503 ComplianceRelated |
---|
This method has been disabled. |
Contact the Exchange support team at exchange.support@se.com. In your request please :
- mention the involved endpoint
- give the request that generate the error
- copy past any error message you received
- add some screen shot
Authentication is the act of proving an assertion, such as the identify of a computer system user.
Security scheme type | API Key |
Header parameter name | Authorization |
In contrast with identification, the act of indicating a person or thing's identity, authentication is the process of verifying that identify.