The files are provided courtesy of SSEC/AOSS UW-Madison. Clients causing issues due to size or quantity of queries may be blocked from further access until the issue is resolved
Currently, there are level_00 products from 2 instrument platforms accessible through this interface, the AOSS AERI and AOSS Tower. Level_00 products for the Mendota Buoy and level_a0 products for the AOSS Tower and Mendota Buoy will be made available soon.
The base URL of a files query specifies the requested file return format:
http://metobs.ssec.wisc.edu/api/files.<fmt>
Valid values for fmt are:
csv json sh bat
The formats are documented below in the section Data Formats.
The query string will specify what specific files you would like to query for. The standard format for a HTTP GET query string can be found at http://en.wikipedia.org/wiki/query_string. Essentially, separate the URL from the query string using a ? and the key=value parameters with a &. Depending on the client, you may need to use URL character encoding in the URL, such as a + in place of any spaces. For more information see Example queries.
The query string supports the following query parameters:
begin: | Start of the query interval in UTC as YYYY-MM-DD or -<number of days>. If the format -<number of days> is used, begin is interpreted as a relative time starting from the current date. If begin is not specified, it provides the latest files based upon the end parameter. |
streams: |
(Required) Colon separated list of product attributes to query for.
streams are specified as a colon separated list of '<site>.<instrument>.<product_id>.<product_level>.<version_number>'.
The version number may be specificed as '*' to choose the most recent version.
The product ID may also be specified as '*' to choose all products for a given level.
Note: level and version is abbreviated (i.e. level_00 becomes l00 and version_00 becomes v00). Valid streams quantifiers for each site/instrument are documented below. |
end: | End of the query interval in UTC as YYYY-MM-DD. If not provided, it defaults to today. |
dates: | Individual query dates separated by colons in the format of YYYY-MM-DD. If provided, this parameter overrides the begin and end parameters. |
Stream Name | File Pattern | Description |
aoss.tower.*.l00.* | N/A | |
aoss.tower.*.l00.v00 | N/A | |
aoss.tower.*.lb1.* | N/A | |
aoss.tower.*.lb1.v00 | N/A | |
aoss.tower.accum-precip-daily.lb1.* | aoss_tower.accum_precip.%Y-%m-%d.png | |
aoss.tower.accum-precip-daily.lb1.v00 | aoss_tower.accum_precip.%Y-%m-%d.png | |
aoss.tower.ascii.l00.* | aoss_tower.%Y-%m-%d.ascii | |
aoss.tower.ascii.l00.v00 | aoss_tower.%Y-%m-%d.ascii | |
aoss.tower.meteorogram-daily.lb1.* | aoss_tower.meteorogram.%Y-%m-%d.png | |
aoss.tower.meteorogram-daily.lb1.v00 | aoss_tower.meteorogram.%Y-%m-%d.png | |
aoss.tower.nc-daily.lb1.* | aoss_tower.%Y-%m-%d.nc | |
aoss.tower.nc-daily.lb1.v00 | aoss_tower.%Y-%m-%d.nc | |
aoss.tower.pressure-daily.lb1.* | aoss_tower.pressure.%Y-%m-%d.png | |
aoss.tower.pressure-daily.lb1.v00 | aoss_tower.pressure.%Y-%m-%d.png | |
aoss.tower.solar-flux-daily.lb1.* | aoss_tower.solar_flux.%Y-%m-%d.png | |
aoss.tower.solar-flux-daily.lb1.v00 | aoss_tower.solar_flux.%Y-%m-%d.png | |
aoss.tower.td-daily.lb1.* | aoss_tower.td.%Y-%m-%d.png | |
aoss.tower.td-daily.lb1.v00 | aoss_tower.td.%Y-%m-%d.png | |
aoss.tower.wind-dir-daily.lb1.* | aoss_tower.wind_dir.%Y-%m-%d.png | |
aoss.tower.wind-dir-daily.lb1.v00 | aoss_tower.wind_dir.%Y-%m-%d.png | |
aoss.tower.wind-speed-daily.lb1.* | aoss_tower.wind_speed.%Y-%m-%d.png | |
aoss.tower.wind-speed-daily.lb1.v00 | aoss_tower.wind_speed.%Y-%m-%d.png |
Stream Name | File Pattern | Description |
aoss.aeri.*.l00.* | N/A | |
aoss.aeri.*.l00.v00 | N/A | |
aoss.aeri.csv-f1.l00.* | %y%m%dF1.CSV | |
aoss.aeri.csv-f1.l00.v00 | %y%m%dF1.CSV | |
aoss.aeri.csv-f2.l00.* | %y%m%dF2.CSV | |
aoss.aeri.csv-f2.l00.v00 | %y%m%dF2.CSV | |
aoss.aeri.cxs-b1.l00.* | %y%m%dB1.CXS | |
aoss.aeri.cxs-b1.l00.v00 | %y%m%dB1.CXS | |
aoss.aeri.cxs-b2.l00.* | %y%m%dB2.CXS | |
aoss.aeri.cxs-b2.l00.v00 | %y%m%dB2.CXS | |
aoss.aeri.cxs-f1.l00.* | %y%m%dF1.CXS | |
aoss.aeri.cxs-f1.l00.v00 | %y%m%dF1.CXS | |
aoss.aeri.cxs-f2.l00.* | %y%m%dF2.CXS | |
aoss.aeri.cxs-f2.l00.v00 | %y%m%dF2.CXS | |
aoss.aeri.par.l00.* | %y%m%d.PAR | |
aoss.aeri.par.l00.v00 | %y%m%d.PAR | |
aoss.aeri.qc.l00.* | %y%m%d.QC | |
aoss.aeri.qc.l00.v00 | %y%m%d.QC | |
aoss.aeri.rnc-c1.l00.* | %y%m%dC1.RNC | |
aoss.aeri.rnc-c1.l00.v00 | %y%m%dC1.RNC | |
aoss.aeri.rnc-c2.l00.* | %y%m%dC2.RNC | |
aoss.aeri.rnc-c2.l00.v00 | %y%m%dC2.RNC | |
aoss.aeri.scr-aesitter.l00.* | AESITTER.SCR | |
aoss.aeri.scr-aesitter.l00.v00 | AESITTER.SCR | |
aoss.aeri.scr-radiance.l00.* | RADIANCE.SCR | |
aoss.aeri.scr-radiance.l00.v00 | RADIANCE.SCR | |
aoss.aeri.scr-summary.l00.* | SUMMARY.SCR | |
aoss.aeri.scr-summary.l00.v00 | SUMMARY.SCR | |
aoss.aeri.sum.l00.* | %y%m%d.SUM | |
aoss.aeri.sum.l00.v00 | %y%m%d.SUM | |
aoss.aeri.uvs-b1.l00.* | %y%m%dB1.UVS | |
aoss.aeri.uvs-b1.l00.v00 | %y%m%dB1.UVS | |
aoss.aeri.uvs-b2.l00.* | %y%m%dB2.UVS | |
aoss.aeri.uvs-b2.l00.v00 | %y%m%dB2.UVS | |
aoss.aeri.uvs-f1.l00.* | %y%m%dF1.UVS | |
aoss.aeri.uvs-f1.l00.v00 | %y%m%dF1.UVS | |
aoss.aeri.uvs-f2.l00.* | %y%m%dF2.UVS | |
aoss.aeri.uvs-f2.l00.v00 | %y%m%dF2.UVS |
Product levels are based on the ARM data levels. More information can be found here.
# status: success # code: 200 # message: # num_results: 2 # Fields: filename, url, site, inst, level, size rig_tower.2016-08-03.ascii,http://metobs.ssec.wisc.edu/pub/cache/aoss/tower/level_00/version_00/2016/08/rig_tower.2016-08-03.ascii,aoss,tower,level_00,0 rig_tower.2016-08-04.ascii,http://metobs.ssec.wisc.edu/pub/cache/aoss/tower/level_00/version_00/2016/08/rig_tower.2016-08-04.ascii,aoss,tower,level_00,0
For displaying data using javascript or AJAX, use a JSON format. The api automatically returns that format as a CORS HTTP request; this particular CORS request allows cross origin get requests.
{ "code": 200, "data": [ { "filename": "rig_tower.2016-08-03.ascii", "inst": "tower", "level": "level_00", "site": "aoss", "size": 0, "url": "http://metobs.ssec.wisc.edu/pub/cache/aoss/tower/level_00/version_00/2016/08/rig_tower.2016-08-03.ascii" }, { "filename": "rig_tower.2016-08-04.ascii", "inst": "tower", "level": "level_00", "site": "aoss", "size": 0, "url": "http://metobs.ssec.wisc.edu/pub/cache/aoss/tower/level_00/version_00/2016/08/rig_tower.2016-08-04.ascii" } ], "message": "", "num_results": 2, "status": "success" }
#!/usr/bin/env bash # status: success # code: 200 # message: # num_results: 2 # # Instructions for post-download: # 1. Using the command line, go to the directory where this script is saved # 2. Make this script executable 'chmod +x <name of script>' # 3. Run the script 'bash <name of script>' #Create directory structure CWD=$(pwd) if [[ ! -d data ]]; then mkdir data fi cd data #get files xargs -n1 curl --create-dirs -o '#1' <<EOF http://metobs.ssec.wisc.edu/pub/cache/{aoss/tower/level_00/version_00/2016/08/rig_tower.2016-08-03.ascii} http://metobs.ssec.wisc.edu/pub/cache/{aoss/tower/level_00/version_00/2016/08/rig_tower.2016-08-04.ascii} EOF
@echo off REM status: success REM code: 200 REM message: REM num_results: 2 REM Instructions for post-download: REM 1. Using windows' command line, go to the directory where this script is saved REM 2. Tap in REM 3. Hold ctrl + c when download are done and hit Y, then enter REM 4. Finally, files will be in a data directory if not exist %cd%\data\aoss\tower\level_00\version_00\2016\08 ( mkdir %cd%\data\aoss\tower\level_00\version_00\2016\08 ) if not exist %cd%\data\aoss\tower\level_00\version_00\2016\08 ( mkdir %cd%\data\aoss\tower\level_00\version_00\2016\08 ) bitsadmin /create myDownloadJob bitsadmin /addfile myDownloadJob http://metobs.ssec.wisc.edu/pub/cache/aoss/tower/level_00/version_00/2016/08/rig_tower.2016-08-03.ascii %cd%\data\aoss\tower\level_00\version_00\2016\08rig_tower.2016-08-03.ascii bitsadmin /addfile myDownloadJob http://metobs.ssec.wisc.edu/pub/cache/aoss/tower/level_00/version_00/2016/08/rig_tower.2016-08-04.ascii %cd%\data\aoss\tower\level_00\version_00\2016\08rig_tower.2016-08-04.ascii bitsadmin /resume myDownloadJob bitsadmin /SetNotifyCmdLine myDownloadJob "%SystemRoot%\system32\bitsadmin.exe" "%SystemRoot%\syste,32\bitsadmin.exe /complete myDownloadJob" bitsadmin /monitor
If you have comments, suggestions, or require help, please contact the MetObs Webmaster.