Skip to content
  • There are no suggestions because the search field is empty.

Weather Export Format

MyDataHelps can collect weather forecast data from weatherbit.io for each participant. Each sample contains data for the 24-hour weather forecast for the indicated postal code. If the project has Custom Fields with names ending in "PostalCode" (e.g. WorkPostalCode or SchoolPostalCode), there will be one daily sample for each postal code.


Data Fields

Field Description
ParticipantIdentifier The MyDataHelps identifier of the participant. Can be used to cross reference with Participants.
ParticipantID
The stable, automatically generated, internal system identifier for this participant. Universally unique identifier (UUID).
Date The date the sample was recorded, in ISO 8601 format.
PostalCode

The postal code for which data was recorded.

Type

Samples from their home postal code will have a type of WeatherData.

Samples from other postal codes will be named to match the custom field name. For example: WorkPostalCode will have a type of WorkWeatherData.

LowTemperature The expected low temperature (in degrees Fahrenheit) using a 6AM to 6AM meteorological day
HighTemperature The expected high temperature (in degrees Fahrenheit) using a 6AM to 6AM meteorological day
MinTemperature The minimum temperature (in degrees Fahrenheit) expected in the next 24 hours
MaxTemperature The maximum temperature (in degrees Fahrenheit) expected in the next 24 hours
LiquidEquivalentPrecipitation Expected rain or equivalent precipitation (in inches)
SnowAccumulation Expected snow accumulation (in inches)
ProbabilityOfPrecipitation Probability of there being precipitation in the next 24 hours (as a %)
FeelsLikeLowTemperature Apparent/"Feels Like" temperature at LowTemperature time (in degrees Fahrenheit)
FeelsLikeHighTemperature Apparent/"Feels Like" temperature at HighTemperature time (in degrees Fahrenheit)
AverageTemperature Average Temperature (in degrees Fahrenheit)
SnowDepth Snow Depth (in inches)
AverageCloudCoverage Average total cloud coverage (%)
HighLevelCloudCoverage High-level (>5km AGL) cloud coverage (%)
MidLevelCloudCoverage Mid-level (~3-5km AGL) cloud coverage (%)
LowLevelCloudCoverage Low-level (~0-3km AGL) cloud coverage (%)
DewPoint Average dew point (in degrees Fahrenheit)
RelativeHumidity Average relative humidity (%)
Pressure Average pressure (in millibars)
SeaLevelPressure Average sea level pressure (in millibars)
MoonPhaseIlluminationFraction Moon phase illumination fraction (0-1)
MoonPhaseLunationFraction Moon lunation fraction (0 = New moon, 0.50 = Full Moon, 0.75 = Last quarter moon)
Moonrise Moonrise time (UTC)
Moonset Moonset time (UTC)
Sunrise Sunrise time (UTC)
Sunset Sunset time (UTC)
Ozone Average Ozone (in Dobson units)
MaximumUVIndex Maximum UV Index (0-11+)
VisibilityDistance Visibility (in miles)
WeatherDescription Text weather description (e.g., Overcast clouds)
WindDirectionAbbreviated Abbreviated wind direction (e.g., SE)
WindDirectionVerbal Verbal wind direction (e.g., southeast)
WindDirectionDegrees Wind direction (in degrees)
WindSpeed Wind speed (in mph)
WindGustSpeed Wind gust speed (in mph)

Sample CSV Export

ParticipantIdentifier,Date,PostalCode,Type,LowTemperature,HighTemperature,MinTemperature,MaxTemperature,LiquidEquivalentPrecipitation,SnowAccumulation,ProbabilityOfPrecipitation,ParticipantID,SnowDepth,FeelsLikeLowTemperature,FeelsLikeHighTemperature,AverageTemperature,AverageCloudCoverage,HighLevelCloudCoverage,MidLevelCloudCoverage,LowLevelCloudCoverage,DewPoint,RelativeHumidity,Pressure,SeaLevelPressure,MoonPhaseIlluminationFraction,MoonPhaseLunationFraction,Moonrise,Moonset,Sunrise,Sunset,Ozone,MaximumUVIndex,VisibilityDistance,WeatherDescription,WindDirectionAbbreviated,WindDirectionVerbal,WindDirectionDegrees,WindSpeed,WindGustSpeed
MDH-5169-3832,2024-04-19T13:05:37+00:00,20853,WeatherData,50.8,64.6,47.8,64.6,0,0,0,34df55c7-82d1-ee11-af22-745d2286bc4a,0,48.8,62.7,55.5,73,20,33,95,47.5,75,1002,1015,0.89,0.38,2024-04-19T19:54:14,2024-04-19T09:00:48,2024-04-19T10:24:40,2024-04-19T23:50:55,340,3,9.9,Overcast clouds,SE,southeast,130,7.6,11.4

Sample JSON Export

{
"ParticipantIdentifier":"MDH-5169-3832",
"Date":"2024-04-19T13:05:37+00:00",
"PostalCode":"20853",
"Type":"WeatherData",
"LowTemperature":"50.8",
"HighTemperature":"64.6",
"MinTemperature":"47.8",
"MaxTemperature":"64.6",
"LiquidEquivalentPrecipitation":"0",
"SnowAccumulation":"0",
"ProbabilityOfPrecipitation":"0",
"ParticipantID":"34DF55C7-82D1-EE11-AF22-745D2286BC4A",
"FeelsLikeLowTemperature":"48.8",
"FeelsLikeHighTemperature":"62.7",
"AverageTemperature":"55.5",
"SnowDepth":"0",
"AverageCloudCoverage":"73",
"HighLevelCloudCoverage":"20",
"MidLevelCloudCoverage":"33",
"LowLevelCloudCoverage":"95",
"DewPoint":"47.5",
"RelativeHumidity":"75",
"Pressure":"1002",
"SeaLevelPressure":"1015",
"MoonPhaseIlluminationFraction":"0.89",
"MoonPhaseLunationFraction":"0.38",
"Moonrise":"2024-04-19T19:54:14",
"Moonset":"2024-04-19T09:00:48",
"Sunrise":"2024-04-19T10:24:40",
"Sunset":"2024-04-19T23:50:55",
"Ozone":"340",
"MaximumUVIndex":"3",
"VisibilityDistance":"9.9",
"WeatherDescription":"Overcast clouds",
"WindDirectionAbbreviated":"SE",
"WindDirectionVerbal":"southeast",
"WindDirectionDegrees":"130",
"WindSpeed":"7.6",
"WindGustSpeed":"11.4"
}