Get robotic accessor reports

Edit online

The accessor report contains the usage history for the accessor, including pivots, scans, distance traveled, and puts or gets done by the two grippers. These reports are taken at intervals of one hour and kept for one year. However, you can offload only one week of data at a time by using the GET command to ensure the query response size does not get too large. If you do not include query parameters to limit the time frame, all reports for the last week will be returned.

Request syntax

GET /v1/reports/accessors
Retrieves all reports for the last week.

Query parameters

after (string, optional): The time after which reports should be viewed. Any report with a time matching or before this time will not be returned. Time format is YYYY-MM-DDThh:mm:ss±hh:mm. This defaults to the current date and time of the library.

before (string, optional): The time before which reports should be viewed. Any report with a time matching or after this time will not be returned. Time format is YYYY-MM-DDThh:mm:ss±hh:mm. This defaults to one week ago.

Example

> GET /v1/reports/accessors
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1903

[
     {
          "location": "accessor_Aa",
          "time": "2019-04-03T11:13:44-0700",
          "duration": 3600,
          "pivots": 55,
          "barCodeScans": 4056,
          "travelX": 50,
          "travelY": 75,
          "getsGripper1": 50,
          "putsGripper1": 50,
          "getsGripper2": 70,
          "putsGripper2": 69,
          "temperatureAverage": 24.1,
          "temperatureMin": 24.0,
          "temperatureMax": 25.0,
          "humidityAverage": 24.1,
          "humidityMin": 24.0,
          "humidityMax": 25.0
     }, {
          . . .
     }
]

Attributes

location (string): The unique location of the accessor.
time (string): The time at which this data entry was recorded. Time format is YYYY-MM-DDThh:mm:ss±hh:mm.
duration (number): The number of seconds this data entry was recorded over.
pivots (number): The number of pivots performed over the duration. For Diamondback, this is always 0 as the accessor does not pivot.
barCodeScans (number): The number of bar code scans performed over the duration.
travelX (number): The number of meters of movement in the X (horizontal) direction over the duration.
travelY (number): The number of meters of movement in the Y (vertical) direction over the duration.
getsGripper1 (number): The number cartridge retrieval actions performed by gripper 1 over the duration.
putsGripper1 (number): The number cartridge placement actions performed by gripper 1 over the duration.
getsGripper2 (number): The number cartridge retrieval actions performed by gripper 2 over the duration.
putsGripper2 (number): The number cartridge placement actions performed by gripper 2 over the duration.
temperatureAverage (number): The average temperature in Celsius measured by the accessor over the duration, accurate to one decimal place. For TS4500, null is returned as there is no sensor.
temperatureMin (number): The minimum temperature in Celsius to one decimal place measured by the accessor over the duration, accurate to one decimal place. For TS4500, null is returned as there is no sensor.
temperatureMax (number): The maximum temperature in Celsius to one decimal place measured by the accessor over the duration, accurate to one decimal place. For TS4500, null is returned as there is no sensor.
humidityAverage (number): The average percent humidity accurate to one decimal place measured by the accessor over the duration. For TS4500, null is returned as there is no sensor.
humidityMin (number): The minimum percent humidity to one decimal place measured by the accessor over the duration. For TS4500, null is returned as there is no sensor.
humidityMax (number): The maximum percent humidity to one decimal place measured by the accessor over the duration. For TS4500, null is returned as there is no sensor.