$ curl -X GET 'http://1lv11lamb01.nrel.gov:8091/'
{
"status":{
"state":"ok",
"message":"operating normally"
},
"server_id":"AESD Haystack",
"server_type":"record_server",
"models":[
"RSF2v0"
],
"version":1
}
$ curl -X GET 'http://1lv11lamb01.nrel.gov:8091/models/RSF2v0'
{
"record_id_var":"time",
"variables":[
{
"display":{
"shortlabel":"Time",
"label":"Time Stamp"
},
"domain":{ "set":{ "options":[ ] } },
"is_input":false,
"var_id":"time"
},
{
"display":{
"shortlabel":"Seconds",
"label":"POSIX Seconds"
},
"domain":{ "interval":{ "bounds":[ 315558000, null ] } },
"is_input":false,
"var_id":"epoch",
"units":{ "scale":1, "SI":[ 0, 0, 1, 0, 0, 0, 0, 0 ] }
},
{
"display":{
"shortlabel":"@1edb6d30-d9847159",
"label":"RSF2 PV Generation Power"
},
"domain":{ "interval":{ "bounds":[ null, null ] } },
"is_input":false,
"var_id":"@1edb6d30-d9847159",
"units":{ "scale":1000, "SI":[ 2, 1, -3, 0, 0, 0, 0, 0 ] }
},
{
"display":{
"shortlabel":"@1edb6d30-ce98398c",
"label":"RSF2 Plug Loads Power"
},
"domain":{ "interval":{ "bounds":[ null, null ] } },
"is_input":false,
"var_id":"@1edb6d30-ce98398c",
"units":{ "scale":1000, "SI":[ 2, 1, -3, 0, 0, 0, 0, 0 ] }
},
{
"display":{
"shortlabel":"@1edb6d30-bcf051ea",
"label":"RSF2 Panel SWB Power"
},
"domain":{ "interval":{ "bounds":[ null, null ] } },
"is_input":false,
"var_id":"@1edb6d30-bcf051ea",
"units":{ "scale":1000, "SI":[ 2, 1, -3, 0, 0, 0, 0, 0 ] }
},
{
"display":{
"shortlabel":"@1edb6d30-a9d7ca09",
"label":"RSF2 Panel H2 Power"
},
"domain":{ "interval":{ "bounds":[ null, null ] } },
"is_input":false,
"var_id":"@1edb6d30-a9d7ca09",
"units":{ "scale":1000, "SI":[ 2, 1, -3, 0, 0, 0, 0, 0 ] }
},
{
"display":{
"shortlabel":"@1edb6d30-f6668673",
"label":"RSF2 Occupant Elevator Power"
},
"domain":{ "interval":{ "bounds":[ null, null ] } },
"is_input":false,
"var_id":"@1edb6d30-f6668673",
"units":{ "scale":1000, "SI":[ 2, 1, -3, 0, 0, 0, 0, 0 ] }
},
{
"display":{
"shortlabel":"@1edb6d30-9a89271e",
"label":"RSF2 Mechanical Power"
},
"domain":{ "interval":{ "bounds":[ null, null ] } },
"is_input":false,
"var_id":"@1edb6d30-9a89271e",
"units":{ "scale":1000, "SI":[ 2, 1, -3, 0, 0, 0, 0, 0 ] }
},
{
"display":{
"shortlabel":"@1edb6d30-f64869a4",
"label":"RSF2 Main Meter Power"
},
"domain":{ "interval":{ "bounds":[ null, null ] } },
"is_input":false,
"var_id":"@1edb6d30-f64869a4",
"units":{ "scale":1000, "SI":[ 2, 1, -3, 0, 0, 0, 0, 0 ] }
},
{
"display":{
"shortlabel":"@1edb6d30-6e697a28",
"label":"RSF2 Lighting Power"
},
"domain":{ "interval":{ "bounds":[ null, null ] } },
"is_input":false,
"var_id":"@1edb6d30-6e697a28",
"units":{ "scale":1000, "SI":[ 2, 1, -3, 0, 0, 0, 0, 0 ] }
},
{
"display":{
"shortlabel":"@1edb6d30-a4ccaaf4",
"label":"RSF2 Freight Elevator Power"
},
"domain":{ "interval":{ "bounds":[ null, null ] } },
"is_input":false,
"var_id":"@1edb6d30-a4ccaaf4",
"units":{ "scale":1000, "SI":[ 2, 1, -3, 0, 0, 0, 0, 0 ] }
},
{
"display":{
"shortlabel":"@1edb6d30-db52fab5",
"label":"RSF2 Emergency Lighting Power"
},
"domain":{ "interval":{ "bounds":[ null, null ] } },
"is_input":false,
"var_id":"@1edb6d30-db52fab5",
"units":{ "scale":1000, "SI":[ 2, 1, -3, 0, 0, 0, 0, 0 ] }
},
{
"display":{
"shortlabel":"@1edb6d30-fa21e31d",
"label":"RSF2 Elevators Power"
},
"domain":{ "interval":{ "bounds":[ null, null ] } },
"is_input":false,
"var_id":"@1edb6d30-fa21e31d",
"units":{ "scale":1000, "SI":[ 2, 1, -3, 0, 0, 0, 0, 0 ] }
},
{
"display":{
"shortlabel":"@1edb6d30-1e909c64",
"label":"RSF2 Building Load Power"
},
"domain":{ "interval":{ "bounds":[ null, null ] } },
"is_input":false,
"var_id":"@1edb6d30-1e909c64",
"units":{ "scale":1000, "SI":[ 2, 1, -3, 0, 0, 0, 0, 0 ] }
},
{
"display":{
"shortlabel":"@1edb6d30-5d812ce6",
"label":"RSF2 AC-3 Power"
},
"domain":{ "interval":{ "bounds":[ null, null ] } },
"is_input":false,
"var_id":"@1edb6d30-5d812ce6",
"units":{ "scale":1000, "SI":[ 2, 1, -3, 0, 0, 0, 0, 0 ] }
},
{
"display":{
"shortlabel":"@1edb6d30-60aa00e5",
"label":"RSF2 AC-2/2a Power"
},
"domain":{ "interval":{ "bounds":[ null, null ] } },
"is_input":false,
"var_id":"@1edb6d30-60aa00e5",
"units":{ "scale":1000, "SI":[ 2, 1, -3, 0, 0, 0, 0, 0 ] }
},
{
"display":{
"shortlabel":"@1edb6d30-73828443",
"label":"RSF2 AC-1 Power"
},
"domain":{ "interval":{ "bounds":[ null, null ] } },
"is_input":false,
"var_id":"@1edb6d30-73828443",
"units":{ "scale":1000, "SI":[ 2, 1, -3, 0, 0, 0, 0, 0 ] }
}
],
"model_id":"RSF2v0",
"time_key":"epoch",
"model_uri":"http://www.nrel.gov/sustainable_nrel/rsf.html#RSF2v0",
"generation":1468640371,
"description":"Selected power meters from the RSF 2",
"label":"RSF 2 Version 0",
"record_count":0,
"tags":{
"DC.source":"https://skyspark-ops.nrel.gov/proj/nrel",
"DC.description":"Selected power meters from the RSF 2",
"DC.creator":"Brian W Bush <brian.bush@nrel.gov"
}
}
$ curl -X GET 'http://1lv11lamb01.nrel.gov:8091/models/RSF2v0/records'
[]
Retrieving an empty result just means that no records are cached. To pull records from SkySpark, we need to specify a starting time and (optionally) a finishing time. A starting time is required because without it the voluminous whole history of measurements would be returned.
The generation number is simple the Unix Epoch time in seconds. Using that as the key makes it easy to select times of interest that have not already been cached on the server.
$ curl -X GET 'http://1lv11lamb01.nrel.gov:8091/models/RSF2v0/records?from=1468640300&to=1468640960'
[
{
"variables":[
{"id":"epoch","value":1468640340},
{"id":"@1edb6d30-1e909c64","value":5.2928572573832104},
{"id":"time","value":"2016-07-15T21:39:00-06:00 Denver"},
{"id":"@1edb6d30-6e697a28","value":4.822857243674142},
{"id":"@1edb6d30-9a89271e","value":0.3400000035762787},
{"id":"@1edb6d30-fa21e31d","value":0.1300000101327896}
],
"id":"1468640340"
},
{
"variables":[
{"id":"epoch","value":1468640365},
{"id":"@1edb6d30-1e909c64","value":5.2928572573832104},
{"id":"time","value":"2016-07-15T21:39:25-06:00 Denver"},
{"id":"@1edb6d30-6e697a28","value":4.822857243674142},
{"id":"@1edb6d30-9a89271e","value":0.3400000035762787},
{"id":"@1edb6d30-fa21e31d","value":0.1300000101327896},
{"id":"@1edb6d30-a4ccaaf4","value":0.36000001430511475}
],
"id":"1468640365"
},
.
.
.
{
"variables":[
{"id":"epoch","value":1468640813},
{"id":"@1edb6d30-5d812ce6","value":-0.3400000035762787},
{"id":"@1edb6d30-d9847159","value":0},
{"id":"@1edb6d30-60aa00e5","value":0.3100000023841858},
{"id":"@1edb6d30-73828443","value":0.5099999904632568},
{"id":"@1edb6d30-1e909c64","value":0.33000001311302185},
{"id":"time","value":"2016-07-15T21:46:53-06:00 Denver"},
{"id":"@1edb6d30-6e697a28","value":4.789999961853027},
{"id":"@1edb6d30-9a89271e","value":-3.0000001192092896e-2},
{"id":"@1edb6d30-fa21e31d","value":0.36000001430511475},
{"id":"@1edb6d30-f6668673","value":-0.23000000417232513},
{"id":"@1edb6d30-db52fab5","value":4.789999961853027},
{"id":"@1edb6d30-f64869a4","value":35.65999984741211},
{"id":"@1edb6d30-a4ccaaf4","value":0.36000001430511475}
],
"id":"1468640813"
}
]
The server is combining observations at different measurement times: i.e., not all variables are measured at exactly the same time. In fact some variables are measured at high frequency, and others at low frequency. One could imagine several strategies for dealing with this within the AESD Records API:
- Only report measurements at the time they were measured. This would result in a many records with missing values.
- At each time where a measurement has been made, report the most recently measured value of all of the variables.
- Use interpolation or extrapolation to align the variables to a particular time slice.
This server currently uses a variation of the second strategy: Starting just before the start of the query window, all values are missing. Then the most recently measured value is retained in the reporting at later times.
We can also retreive the records after a certain time.
$ curl -X GET 'http://1lv11lamb01.nrel.gov:8091/models/RSF2v0/records?from=1468640800'
[
{
"variables":[
{"id":"epoch","value":1468640806},
{"id":"@1edb6d30-5d812ce6","value":-0.3400000035762787},
{"id":"time","value":"2016-07-15T21:46:46-06:00 Denver"}
],
"id":"1468640806"
},
{
"variables":[
{"id":"epoch","value":1468640813},
{"id":"@1edb6d30-5d812ce6","value":-0.3400000035762787},
{"id":"@1edb6d30-60aa00e5","value":0.3100000023841858},
{"id":"time","value":"2016-07-15T21:46:53-06:00 Denver"}
],
"id":"1468640813"
}
]
$ curl -X POST --data-ascii '{"command" : "clear"}' 'http://1lv11lamb01.nrel.gov:8091/models/RSF2v0/command'
{"result":"server reinitialized"}
$ curl -X GET 'http://1lv11lamb01.nrel.gov:8091/models/RSF2v0/records'
[]