Returns the power quality data for the requested panels. Power quality is reported in terms of Total Harmonic Distortion (THD). THD is the ratio of the root mean square (RMS) amplitude of a set of higher harmonic frequencies to the RMS amplitude of the first harmonic, or fundamental, frequency (60Hz).

THD = sqrt(V2^2 + V3^2 + … + Vn^2)/V1 where Vn is the RMS voltage of the nth harmonic and n = 1 is the fundamental frequency (60H in US, 50Hz in Europe, etc).

If power quality is null, the panel is missing data for that time interval.

Example Request

$ curl -G \
"https://app.verdigris.co/api/v3/panels/power_quality?\
ids=1,2&\
start_time=2017-06-20T23:55:00Z&\
end_time=2017-06-20T23:57:00Z&\
interval=minutely&\
timestamp_format=iso8601" \
--data-urlencode "timezone=Pacific Time (US & Canada)" \
-H "Authorization: Token token=<access_token>"

Examples

# RESPONSE
# result is in the format:
# {
#     panel_id0: {
#         "timestamps": [
#             timestamp0,
#             timestamp1
#         ],
#         "phase_A": [
#             power_quality_00,
#             power_quality_01
#         ],
#         "phase_B": [
#             power_quality_10,
#             power_quality_11
#         ],
#         "phase_C": [
#             power_quality_20,
#             power_quality_21
#         ]
#     },
#     "panel_id2": {
#         "timestamps": [
#             timestamp0,
#             timestamp1
#         ],
#         "phase_A": [
#             power_quality_00,
#             power_quality_01
#         ],
#         "phase_B": [
#             power_quality_10,
#             power_quality_11
#         ],
#         "phase_C": [
#             power_quality_20,
#             power_quality_21
#         ]
#     }
# }
{
    "1": {
        "timestamps": [
            "2017-06-20T16:55:00-07:00",
            "2017-06-20T16:56:00-07:00"
        ],
        "phase_A": [
            0.8,
            1.0
        ],
        "phase_B": [
            0.2,
            0.2
        ],
        "phase_C": [
            1.1,
            1.0
        ]
    },
    "2": {
        "timestamps": [
          "2017-06-20T16:55:00-07:00",
          "2017-06-20T16:56:00-07:00"
        ],
        "phase_A": [
            0.7,
            0.75
        ],
        "phase_B": [
            0.3,
            1.0
        ],
        "phase_C": [
            0.9,
            0.98
        ]
    }
}

Params

Param name Description
ids
required

comma seperated panel ids (e.g. 1,2)


Value:

Must be String

start_time
required

start time in ISO 8601 combined date and time format (e.g. 2016-09-01T00:00:00.000Z), response will be inclusive of start time


Value:

Must be String

end_time
required

end time in ISO 8601 combined date and time format (e.g. 2016-10-01T00:00:00.000Z), response will be exclusive of end time


Value:

Must be String

interval
required

time between each data point


Value:

Must be one of: minutely, 15-minutely, hourly, daily.

timestamp_format
optional

specify how timestamps are returned in the response (default: unix epoch seconds)


Value:

Must be one of: iso8601.

timezone
optional

timezone used to account for hour and day boundaries, and daylight savings (default: UTC)


Value:

Must be one of: International Date Line West, Midway Island, American Samoa, Hawaii, Alaska, Pacific Time (US & Canada), Tijuana, Mountain Time (US & Canada), Arizona, Chihuahua, Mazatlan, Central Time (US & Canada), Saskatchewan, Guadalajara, Mexico City, Monterrey, Central America, Eastern Time (US & Canada), Indiana (East), Bogota, Lima, Quito, Atlantic Time (Canada), Caracas, La Paz, Santiago, Newfoundland, Brasilia, Buenos Aires, Montevideo, Georgetown, Greenland, Mid-Atlantic, Azores, Cape Verde Is., Dublin, Edinburgh, Lisbon, London, Casablanca, Monrovia, UTC, Belgrade, Bratislava, Budapest, Ljubljana, Prague, Sarajevo, Skopje, Warsaw, Zagreb, Brussels, Copenhagen, Madrid, Paris, Amsterdam, Berlin, Bern, Rome, Stockholm, Vienna, West Central Africa, Bucharest, Cairo, Helsinki, Kyiv, Riga, Sofia, Tallinn, Vilnius, Athens, Istanbul, Minsk, Jerusalem, Harare, Pretoria, Kaliningrad, Moscow, St. Petersburg, Volgograd, Samara, Kuwait, Riyadh, Nairobi, Baghdad, Tehran, Abu Dhabi, Muscat, Baku, Tbilisi, Yerevan, Kabul, Ekaterinburg, Islamabad, Karachi, Tashkent, Chennai, Kolkata, Mumbai, New Delhi, Kathmandu, Astana, Dhaka, Sri Jayawardenepura, Almaty, Novosibirsk, Rangoon, Bangkok, Hanoi, Jakarta, Krasnoyarsk, Beijing, Chongqing, Hong Kong, Urumqi, Kuala Lumpur, Singapore, Taipei, Perth, Irkutsk, Ulaanbaatar, Seoul, Osaka, Sapporo, Tokyo, Yakutsk, Darwin, Adelaide, Canberra, Melbourne, Sydney, Brisbane, Hobart, Vladivostok, Guam, Port Moresby, Magadan, Srednekolymsk, Solomon Is., New Caledonia, Fiji, Kamchatka, Marshall Is., Auckland, Wellington, Nuku’alofa, Tokelau Is., Chatham Is., Samoa, Pacific/Midway, Pacific/Midway, Pacific/Pago_Pago, Pacific/Honolulu, America/Juneau, America/Los_Angeles, America/Tijuana, America/Denver, America/Phoenix, America/Chihuahua, America/Mazatlan, America/Chicago, America/Regina, America/Mexico_City, America/Mexico_City, America/Monterrey, America/Guatemala, America/New_York, America/Indiana/Indianapolis, America/Bogota, America/Lima, America/Lima, America/Halifax, America/Caracas, America/La_Paz, America/Santiago, America/St_Johns, America/Sao_Paulo, America/Argentina/Buenos_Aires, America/Montevideo, America/Guyana, America/Godthab, Atlantic/South_Georgia, Atlantic/Azores, Atlantic/Cape_Verde, Europe/Dublin, Europe/London, Europe/Lisbon, Europe/London, Africa/Casablanca, Africa/Monrovia, Etc/UTC, Europe/Belgrade, Europe/Bratislava, Europe/Budapest, Europe/Ljubljana, Europe/Prague, Europe/Sarajevo, Europe/Skopje, Europe/Warsaw, Europe/Zagreb, Europe/Brussels, Europe/Copenhagen, Europe/Madrid, Europe/Paris, Europe/Amsterdam, Europe/Berlin, Europe/Berlin, Europe/Rome, Europe/Stockholm, Europe/Vienna, Africa/Algiers, Europe/Bucharest, Africa/Cairo, Europe/Helsinki, Europe/Kiev, Europe/Riga, Europe/Sofia, Europe/Tallinn, Europe/Vilnius, Europe/Athens, Europe/Istanbul, Europe/Minsk, Asia/Jerusalem, Africa/Harare, Africa/Johannesburg, Europe/Kaliningrad, Europe/Moscow, Europe/Moscow, Europe/Volgograd, Europe/Samara, Asia/Kuwait, Asia/Riyadh, Africa/Nairobi, Asia/Baghdad, Asia/Tehran, Asia/Muscat, Asia/Muscat, Asia/Baku, Asia/Tbilisi, Asia/Yerevan, Asia/Kabul, Asia/Yekaterinburg, Asia/Karachi, Asia/Karachi, Asia/Tashkent, Asia/Kolkata, Asia/Kolkata, Asia/Kolkata, Asia/Kolkata, Asia/Kathmandu, Asia/Dhaka, Asia/Dhaka, Asia/Colombo, Asia/Almaty, Asia/Novosibirsk, Asia/Rangoon, Asia/Bangkok, Asia/Bangkok, Asia/Jakarta, Asia/Krasnoyarsk, Asia/Shanghai, Asia/Chongqing, Asia/Hong_Kong, Asia/Urumqi, Asia/Kuala_Lumpur, Asia/Singapore, Asia/Taipei, Australia/Perth, Asia/Irkutsk, Asia/Ulaanbaatar, Asia/Seoul, Asia/Tokyo, Asia/Tokyo, Asia/Tokyo, Asia/Yakutsk, Australia/Darwin, Australia/Adelaide, Australia/Melbourne, Australia/Melbourne, Australia/Sydney, Australia/Brisbane, Australia/Hobart, Asia/Vladivostok, Pacific/Guam, Pacific/Port_Moresby, Asia/Magadan, Asia/Srednekolymsk, Pacific/Guadalcanal, Pacific/Noumea, Pacific/Fiji, Asia/Kamchatka, Pacific/Majuro, Pacific/Auckland, Pacific/Auckland, Pacific/Tongatapu, Pacific/Fakaofo, Pacific/Chatham, Pacific/Apia.