Table of Contents

Back to JESS API

Get the EPW Data File


Use GET /epw/<dataset_name> to retrieve the contents of the data file (.epw) of a given dataset name


Synopsis

Return object

A successful /epw/<dataset_name> transaction returns the contents of the EPW file of the given dataset. The datasets can be from either energyplus.net or climate.onebuilding.org. The dataset name is normally the name of the EPW file without the extension .epw.

LOCATION,Hornafjordur AP,AL,ISL,ISD-TMYx,040820,64.29600,-15.22700,0.0,7.3 
DESIGN CONDITIONS,1,2017 ASHRAE Handbook -- Fundamentals - Chapter 14 Climatic Design
Information,,Heating,12,-8.5,-6.9,-16.3,0.9,-7.9,-14.1,1.1,-6.3,22.1,1.3,20,0.4,6.5,340,Cooling,7,4.4,15.6,12.1,14.3,11.5,13.5,11.1,12.9,14.4,12.2,13.5,11.7,12.9,4.9,180,12.1,8.8,13.4,11.6,8.5,12.8,11,8.2,12.3,36.5,14.6,34.9,13.7,33.5,12.9,18.4,Extremes,18.8,15.4,13.4,-10.7,19.2,2.1,2.5,-12.2,20.9,-13.4,22.4,-14.6,23.7,-16.1,25.5,-11.9
TYPICAL/EXTREME PERIODS,6,Summer - Week Nearest Max Temperature For Period,Extreme,7/24,7/30,Summer - Week Nearest Average Temperature For Period,Typical,6/12,6/18,Winter - Week Nearest Min Temperature For Period,Extreme,12/20,12/26,Winter - Week Nearest Average Temperature For Period,Typical,1/11,1/17,Autumn - Week Nearest Average Temperature For Period,Typical,10/10,10/16,Spring - Week Nearest Average Temperature For Period,Typical,2/15,2/21 
GROUND TEMPERATURES,3,.5,,,,0.07,0.95,2.68,4.31,7.40,9.03,9.48,8.65,6.75,4.37,2.03,0.49,2,,,,1.29,1.50,2.49,3.58,5.96,7.48,8.23,8.06,6.98,5.34,3.49,2.04,4,,,,2.55,2.40,2.83,3.45,5.02,6.20,6.96,7.14,6.67,5.70,4.45,3.32 
HOLIDAYS/DAYLIGHT SAVINGS,No,0,0,0 
COMMENTS 1,"NCEI ISD - #years=[47] Period of Record=1973-2019; Jan=1986; Feb=1983; Mar=1980; Apr=1997; May=1988; Jun=1999; Jul=1999; Aug=2001; Sep=1987; Oct=2009; Nov=2004; Dec=1988" 
COMMENTS 2,"Downloaded from Climate.Onebuilding.org -- Ground temps represent undisturbed earth temperatures - calculated from this weather data." 
DATA PERIODS,1,1,Data,Sunday,1/ 1,12/31 
1986,1,1,1,60,?9?9?9?9E0?9?9?9*9*9?9?9?9?9*9?9*9*9*9*9*9*9,2.5,-3.2,64,100419,0,0,270,0,0,0,0,0,0,0,33,12.5,5,5,777.7,77777,9,999999999,7,0.0850,0,88,0.200,0.0,0.0
1986,1,1,2,60,?9?9?9?9E0?9?9?9*9*9?9?9?9?9*9?9*9*9*9*9*9*9,2.4,-3.1,65,100419,0,0,270,0,0,0,0,0,0,0,149,12.2,5,5,777.7,77777,9,999999999,7,0.0850,0,88,0.200,0.0,0.0
1986,1,1,3,60,?9?9?9?9E0?9?9?9?9?9?9?9?9?9?9?9*9?9*9*9*9*9,2.3,-3.0,66,100419,0,0,285,0,0,0,0,0,0,0,60,11.8,9,9,777.7,2100,9,999999999,7,0.0850,0,88,0.200,0.0,0.0
1986,1,1,4,60,?9?9?9?9E0?9?9?9*9*9?9?9?9?9*9?9*9*9*9*9*9*9,2.1,-2.5,69,100416,0,0,271,0,0,0,0,0,0,0,157,11.0,6,6,777.7,2100,9,999999999,8,0.0850,0,88,0.200,0.0,0.0
1986,1,1,5,60,?9?9?9?9E0?9?9?9*9*9?9?9?9?9*9?9*9*9*9*9*9*9,2.0,-2.1,73,100412,0,0,271,0,0,0,0,0,0,0,163,10.1,6,6,777.7,2100,9,999999999,8,0.0850,0,88,0.200,0.0,0.0
1986,1,1,6,60,?9?9?9?9E0?9?9?9?9?9?9?9?9?9?9?9*9?9*9*9*9*9,1.8,-1.6,77,100409,0,0,285,0,0,0,0,0,0,0,60,9.3,9,9,777.7,2100,0,919999999,8,0.0850,0,88,0.200,0.0,0.0
1986,1,1,7,60,?9?9?9?9E0?9?9?9*9*9?9?9?9?9*9?9*9*9*9*9*9*9,2.1,-2.3,71,100432,0,0,272,0,0,0,0,0,0,0,93,10.3,6,6,777.7,2100,9,999999999,8,0.0850,0,88,0.200,0.0,0.0
1986,1,1,8,60,?9?9?9?9E0?9?9?9*9*9?9?9?9?9*9?9*9*9*9*9*9*9,2.3,-3.0,66,100456,0,0,269,0,0,0,0,0,0,0,133,11.3,5,5,777.7,2100,9,999999999,7,0.0850,0,88,0.200,0.0,0.0
...

Example using curl://

Send the /epw/<dataset_name> command using curl:

curl -b cookies https://api.ensims.com/jess_web/api/epw/ISL_AL_Hornafjordur.AP.040820_TMYx

On success, the contents of the EPW file will be returned. If the specified dataset is not found, an HTTP 404 Not Found error will be returned.

Example using Python Requests

Make sure Requests is correctly installed in your Python environment, and run the following lines:

import requests

# Security is not required
r = requests.get('https://api.ensims.com/jess_web/api/epw/ISL_AL_Hornafjordur.AP.040820_TMYx')

# Show returned object  
r.json()