michaeldwan/boulder-smoke-forecast
Extract structured air quality forecast data from maps
Public
57
runs
Run michaeldwan/boulder-smoke-forecast with an API
Use one of our client libraries to get started quickly. Clicking on a library will take you to the Playground tab where you can tweak different inputs, see the results, and copy the corresponding code to use in your own project.
Input schema
The fields you can use to run this model with an API. If you don't give a value for a field its default value will be used.
| Field | Type | Default value | Description |
|---|---|---|---|
| x_coordinate |
integer
|
258
|
X pixel coordinate on the map (defaults to Boulder, CO)
|
| y_coordinate |
integer
|
415
|
Y pixel coordinate on the map (defaults to Boulder, CO)
|
| radius |
integer
|
6
Min: 1 Max: 10 |
Radius in pixels to average color around the point
|
{
"type": "object",
"title": "Input",
"properties": {
"radius": {
"type": "integer",
"title": "Radius",
"default": 6,
"maximum": 10,
"minimum": 1,
"x-order": 2,
"description": "Radius in pixels to average color around the point"
},
"x_coordinate": {
"type": "integer",
"title": "X Coordinate",
"default": 258,
"x-order": 0,
"description": "X pixel coordinate on the map (defaults to Boulder, CO)"
},
"y_coordinate": {
"type": "integer",
"title": "Y Coordinate",
"default": 415,
"x-order": 1,
"description": "Y pixel coordinate on the map (defaults to Boulder, CO)"
}
}
}
Output schema
The shape of the response you’ll get when you run this model with an API.
Schema
{
"type": "object",
"title": "Output",
"required": [
"future_forecast",
"current_forecast",
"color_scale",
"forecast",
"prediction_time",
"debug"
],
"properties": {
"debug": {
"type": "string",
"title": "Debug",
"format": "uri"
},
"forecast": {
"type": "array",
"items": {
"type": "object",
"title": "ForecastEntry",
"required": [
"time",
"pm25_value",
"hour_delta",
"image_url"
],
"properties": {
"time": {
"type": "string",
"title": "Time"
},
"image_url": {
"type": "string",
"title": "Image Url"
},
"hour_delta": {
"type": "integer",
"title": "Hour Delta"
},
"pm25_value": {
"type": "number",
"title": "Pm25 Value"
}
},
"description": "Single forecast entry with time, PM2.5 value, and metadata."
},
"title": "Forecast"
},
"color_scale": {
"type": "array",
"items": {
"type": "object",
"title": "ColorScaleEntry",
"required": [
"value",
"hex"
],
"properties": {
"hex": {
"type": "string",
"title": "Hex"
},
"value": {
"type": "number",
"title": "Value"
}
},
"description": "Single color scale entry with PM2.5 threshold and hex color."
},
"title": "Color Scale"
},
"future_forecast": {
"type": "string",
"title": "Future Forecast",
"format": "uri"
},
"prediction_time": {
"type": "string",
"title": "Prediction Time"
},
"current_forecast": {
"type": "string",
"title": "Current Forecast",
"format": "uri"
}
},
"description": "Pipeline output containing forecast data and visualization."
}
Example API response
View prediction
{'current_forecast': 'https://replicate.delivery/xezq/XUiQYI5cyCYbJ1lYS3qDFzfdMakhhQ9FOuBeyybYF719poNVA/sampling_point_visualization.png',
'debug': 'https://replicate.delivery/xezq/CSMSrAREn3aOJ5qymOF998KV546WHYZuUh8jjr7cHMUfU0mKA/combined_debug.png',
'forecast_data': '{\n'
' "color_scale": [\n'
' {\n'
' "value": 0,\n'
' "hex": "#ffffff"\n'
' },\n'
' {\n'
' "value": 1,\n'
' "hex": "#e6f5ff"\n'
' },\n'
' {\n'
' "value": 2,\n'
' "hex": "#cce5ff"\n'
' },\n'
' {\n'
' "value": 4,\n'
' "hex": "#99ccff"\n'
' },\n'
' {\n'
' "value": 6,\n'
' "hex": "#66b2ff"\n'
' },\n'
' {\n'
' "value": 8,\n'
' "hex": "#3399ff"\n'
' },\n'
' {\n'
' "value": 12,\n'
' "hex": "#0080ff"\n'
' },\n'
' {\n'
' "value": 16,\n'
' "hex": "#66ff66"\n'
' },\n'
' {\n'
' "value": 20,\n'
' "hex": "#99ff33"\n'
' },\n'
' {\n'
' "value": 25,\n'
' "hex": "#ccff00"\n'
' },\n'
' {\n'
' "value": 30,\n'
' "hex": "#ffff00"\n'
' },\n'
' {\n'
' "value": 40,\n'
' "hex": "#ffcc00"\n'
' },\n'
' {\n'
' "value": 60,\n'
' "hex": "#ff9933"\n'
' },\n'
' {\n'
' "value": 100,\n'
' "hex": "#ff6666"\n'
' },\n'
' {\n'
' "value": 200,\n'
' "hex": "#cc66ff"\n'
' }\n'
' ],\n'
' "prediction_time": "2025-08-22T07:00:00-06:00",\n'
' "forecast": [\n'
' {\n'
' "time": "2025-08-22T07:00:00-06:00",\n'
' "pm25_value": 1.518823633773567,\n'
' "hour_delta": -7,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F001.png"\n'
' },\n'
' {\n'
' "time": "2025-08-22T08:00:00-06:00",\n'
' "pm25_value": 1.5536943533635412,\n'
' "hour_delta": -6,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F002.png"\n'
' },\n'
' {\n'
' "time": "2025-08-22T09:00:00-06:00",\n'
' "pm25_value": 1.5562589031519694,\n'
' "hour_delta": -5,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F003.png"\n'
' },\n'
' {\n'
' "time": "2025-08-22T10:00:00-06:00",\n'
' "pm25_value": 1.518823633773567,\n'
' "hour_delta": -4,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F004.png"\n'
' },\n'
' {\n'
' "time": "2025-08-22T11:00:00-06:00",\n'
' "pm25_value": 1.6194528535487875,\n'
' "hour_delta": -3,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F005.png"\n'
' },\n'
' {\n'
' "time": "2025-08-22T12:00:00-06:00",\n'
' "pm25_value": 1.5536943533635412,\n'
' "hour_delta": -2,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F006.png"\n'
' },\n'
' {\n'
' "time": "2025-08-22T13:00:00-06:00",\n'
' "pm25_value": 1.5180741280943226,\n'
' "hour_delta": -1,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F007.png"\n'
' },\n'
' {\n'
' "time": "2025-08-22T14:00:00-06:00",\n'
' "pm25_value": 1.6194528535487875,\n'
' "hour_delta": 0,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F008.png"\n'
' },\n'
' {\n'
' "time": "2025-08-22T15:00:00-06:00",\n'
' "pm25_value": 1.6622299968553835,\n'
' "hour_delta": 1,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F009.png"\n'
' },\n'
' {\n'
' "time": "2025-08-22T16:00:00-06:00",\n'
' "pm25_value": 1.518823633773567,\n'
' "hour_delta": 2,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F010.png"\n'
' },\n'
' {\n'
' "time": "2025-08-22T17:00:00-06:00",\n'
' "pm25_value": 1.5180741280943226,\n'
' "hour_delta": 3,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F011.png"\n'
' },\n'
' {\n'
' "time": "2025-08-22T18:00:00-06:00",\n'
' "pm25_value": 1.6128185001158368,\n'
' "hour_delta": 4,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F012.png"\n'
' },\n'
' {\n'
' "time": "2025-08-22T19:00:00-06:00",\n'
' "pm25_value": 1.518823633773567,\n'
' "hour_delta": 5,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F013.png"\n'
' },\n'
' {\n'
' "time": "2025-08-22T20:00:00-06:00",\n'
' "pm25_value": 1.4787260355428495,\n'
' "hour_delta": 6,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F014.png"\n'
' },\n'
' {\n'
' "time": "2025-08-22T21:00:00-06:00",\n'
' "pm25_value": 1.518823633773567,\n'
' "hour_delta": 7,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F015.png"\n'
' },\n'
' {\n'
' "time": "2025-08-22T22:00:00-06:00",\n'
' "pm25_value": 1.518823633773567,\n'
' "hour_delta": 8,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F016.png"\n'
' },\n'
' {\n'
' "time": "2025-08-22T23:00:00-06:00",\n'
' "pm25_value": 1.5562589031519694,\n'
' "hour_delta": 9,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F017.png"\n'
' },\n'
' {\n'
' "time": "2025-08-23T00:00:00-06:00",\n'
' "pm25_value": 1.5036902379019301,\n'
' "hour_delta": 10,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F018.png"\n'
' },\n'
' {\n'
' "time": "2025-08-23T01:00:00-06:00",\n'
' "pm25_value": 1.4787260355428495,\n'
' "hour_delta": 11,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F019.png"\n'
' },\n'
' {\n'
' "time": "2025-08-23T02:00:00-06:00",\n'
' "pm25_value": 1.4858544114388272,\n'
' "hour_delta": 12,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F020.png"\n'
' },\n'
' {\n'
' "time": "2025-08-23T03:00:00-06:00",\n'
' "pm25_value": 1.4787260355428495,\n'
' "hour_delta": 13,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F021.png"\n'
' },\n'
' {\n'
' "time": "2025-08-23T04:00:00-06:00",\n'
' "pm25_value": 1.518823633773567,\n'
' "hour_delta": 14,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F022.png"\n'
' },\n'
' {\n'
' "time": "2025-08-23T05:00:00-06:00",\n'
' "pm25_value": 1.4128433641921792,\n'
' "hour_delta": 15,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F023.png"\n'
' },\n'
' {\n'
' "time": "2025-08-23T06:00:00-06:00",\n'
' "pm25_value": 1.518823633773567,\n'
' "hour_delta": 16,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F024.png"\n'
' },\n'
' {\n'
' "time": "2025-08-23T07:00:00-06:00",\n'
' "pm25_value": 1.4787260355428495,\n'
' "hour_delta": 17,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F025.png"\n'
' },\n'
' {\n'
' "time": "2025-08-23T08:00:00-06:00",\n'
' "pm25_value": 1.6054182991063404,\n'
' "hour_delta": 18,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F026.png"\n'
' },\n'
' {\n'
' "time": "2025-08-23T09:00:00-06:00",\n'
' "pm25_value": 3.0481784466931923,\n'
' "hour_delta": 19,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F027.png"\n'
' },\n'
' {\n'
' "time": "2025-08-23T10:00:00-06:00",\n'
' "pm25_value": 1.565872002486451,\n'
' "hour_delta": 20,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F028.png"\n'
' },\n'
' {\n'
' "time": "2025-08-23T11:00:00-06:00",\n'
' "pm25_value": 1.4787260355428495,\n'
' "hour_delta": 21,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F029.png"\n'
' },\n'
' {\n'
' "time": "2025-08-23T12:00:00-06:00",\n'
' "pm25_value": 0.06325148058480323,\n'
' "hour_delta": 22,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F030.png"\n'
' },\n'
' {\n'
' "time": "2025-08-23T13:00:00-06:00",\n'
' "pm25_value": 0.12417165107349626,\n'
' "hour_delta": 23,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F031.png"\n'
' },\n'
' {\n'
' "time": "2025-08-23T14:00:00-06:00",\n'
' "pm25_value": 0.3383494783002508,\n'
' "hour_delta": 24,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F032.png"\n'
' },\n'
' {\n'
' "time": "2025-08-23T15:00:00-06:00",\n'
' "pm25_value": 0.2898979485566356,\n'
' "hour_delta": 25,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F033.png"\n'
' },\n'
' {\n'
' "time": "2025-08-23T16:00:00-06:00",\n'
' "pm25_value": 0.4588452621645457,\n'
' "hour_delta": 26,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F034.png"\n'
' },\n'
' {\n'
' "time": "2025-08-23T17:00:00-06:00",\n'
' "pm25_value": 0.2898979485566356,\n'
' "hour_delta": 27,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F035.png"\n'
' },\n'
' {\n'
' "time": "2025-08-23T18:00:00-06:00",\n'
' "pm25_value": 0.38284405241425784,\n'
' "hour_delta": 28,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F036.png"\n'
' },\n'
' {\n'
' "time": "2025-08-23T19:00:00-06:00",\n'
' "pm25_value": 0.38284405241425784,\n'
' "hour_delta": 29,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F037.png"\n'
' },\n'
' {\n'
' "time": "2025-08-23T20:00:00-06:00",\n'
' "pm25_value": 0.12417165107349626,\n'
' "hour_delta": 30,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F038.png"\n'
' },\n'
' {\n'
' "time": "2025-08-23T21:00:00-06:00",\n'
' "pm25_value": 0.4588452621645457,\n'
' "hour_delta": 31,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F039.png"\n'
' },\n'
' {\n'
' "time": "2025-08-23T22:00:00-06:00",\n'
' "pm25_value": 0.4230853984924675,\n'
' "hour_delta": 32,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F040.png"\n'
' },\n'
' {\n'
' "time": "2025-08-23T23:00:00-06:00",\n'
' "pm25_value": 0.12417165107349626,\n'
' "hour_delta": 33,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F041.png"\n'
' },\n'
' {\n'
' "time": "2025-08-24T00:00:00-06:00",\n'
' "pm25_value": 0.12417165107349626,\n'
' "hour_delta": 34,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F042.png"\n'
' },\n'
' {\n'
' "time": "2025-08-24T01:00:00-06:00",\n'
' "pm25_value": 0.12417165107349626,\n'
' "hour_delta": 35,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F043.png"\n'
' },\n'
' {\n'
' "time": "2025-08-24T02:00:00-06:00",\n'
' "pm25_value": 0.18246809887754506,\n'
' "hour_delta": 36,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F044.png"\n'
' },\n'
' {\n'
' "time": "2025-08-24T03:00:00-06:00",\n'
' "pm25_value": 0.12417165107349626,\n'
' "hour_delta": 37,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F045.png"\n'
' },\n'
' {\n'
' "time": "2025-08-24T04:00:00-06:00",\n'
' "pm25_value": 0.12417165107349626,\n'
' "hour_delta": 38,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F046.png"\n'
' },\n'
' {\n'
' "time": "2025-08-24T05:00:00-06:00",\n'
' "pm25_value": 0.12417165107349626,\n'
' "hour_delta": 39,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F047.png"\n'
' },\n'
' {\n'
' "time": "2025-08-24T06:00:00-06:00",\n'
' "pm25_value": 0.06325148058480323,\n'
' "hour_delta": 40,\n'
' "image_url": '
'"https://bouldercast.com/models/all/HRR_FR_SFCSMK_F048.png"\n'
' }\n'
' ]\n'
'}',
'future_forecast': 'https://replicate.delivery/xezq/NzFje5wyODT5LiT08obiK73NOmVlBtPMqTSDk0eN5Kz8poNVA/forecast_animation.gif'}