Weather Export Format
- Updated
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.
Table of Contents
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"
}
Was this article helpful?