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.
$ 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>"
# 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 ] } }
Param name | Description |
---|---|
ids required |
comma seperated panel ids (e.g. Value: Must be String |
start_time required |
start time in ISO 8601 combined date and time format (e.g. Value: Must be String |
end_time required |
end time in ISO 8601 combined date and time format (e.g. 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. |