Waveforms

the waveform of a signal is the shape of its graph as a function of time, independent of its time and magnitude scales and of any displacement in time

Waveforms structure

Waveforms are composed of multiple signals that can be either analogic or digital, the standard format to represent a waveform or an oscillography is the comtrade format, which defines the characteristics of the waveforms (phase, offset, range, etc.) together with the analogic or digital channels.

Scout is compatible with comtrade's format. A comtrade's dataset containing a .cfg and a .dat file can be imported into the platform to store the waveform's representation.

In the following picture we can observe a waveform's structure.

Here we can observe the 3 analogic channels (V1, V2, V3) and 1 digital channel. The digital channel has a section in which is active (value of 1). This region determines the period in which a problem in the net ocurred, it can also be observed in the Voltage lines, which have a lower-than-normal amplitude.

Usually those incidents are paired with an event that explains the cause of the problem.

Waveform visualization

Once a waveform is imported, it can be observed on the platform's workspaces. In the picture below we can observe the Voltage channels of an imported waveform.

Something to note here is the dotted vertical red line, this represents the start of the event that caused the problem in the net.

Together with the voltage information, we can also see the current information, which is represented in the following image.

Waveform creation

Waveforms can be created by two ways, either by ftp by the RSABT devices or through an API call.

In order to insert a waveform by api it can be done by the following endpoint: - POST /api/v2/assets/{assetId}/waveforms - Authentication either by Bearer token or by X-API-KEY - AssetID in which we want to store the waveform - Body example:

{
  "channels_analog": [
    {
      "max": 0,
      "min": 0,
      "name": "string",
      "number": 0,
      "phase": "string",
      "primary": 0,
      "sample_factor": 0,
      "sample_offset": 0,
      "samples": [
        [
          0
        ]
      ],
      "secondary": 0,
      "var_name": "string"
    }
  ],
  "channels_digital": [
    {
      "initial_state": 0,
      "name": "string",
      "number": 0,
      "phase": "string",
      "samples": [
        [
          0
        ]
      ],
      "var_name": "string"
    }
  ],
  "first_event_ts": "2006-01-02T15:04:05-07:00",
  "info": {
    "additionalProp1": {}
  },
  "nominal_frequency": 0,
  "sample_number": 0,
  "sample_rate": 0,
  "start_at": "2006-01-02T15:04:05-07:00"
}