Using the data

These data are derived from raw climate model output and have been formatted for use in Geographic Information System (GIS) software packages. See Updated national climate projections for Aotearoa New Zealand for more information.

The data is provided as NetCDF files using the CF-1.7 Conventions. NetCDF files can be opened and viewed in ArcGIS and QGIS as well as loaded in python (using xarray) or R (using netcdf4).

Data is provided for both baseline values and future change values of each model.

For future change values, there is one file per combination of:

The values for variables represent an annual or seasonal average, averaged over specific time periods. The time periods represented are:

Not all global warming levels are available for each SSP-RCP scenario. A minimum of 4 climate models need to reach a warming level for this warming level to be included in the mean model (MMM).

The following table shows the Warming Levels that are available for each SSP scenario. Green means that this Warming Level is available for this SSP scenario.

Green: mean model is calculated, Red: mean model is not calculated
    future_period wl1.5 wl2 wl3 wl4
variable_name model scenario        
CD18 ACCESS-CM2 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
AWI-CM-1-1-MR ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
CNRM-CM6-1 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
EC-Earth3 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
GFDL-ESM4 ssp245 True True False False
ssp370 True True True False
ssp585 True True True False
MMM ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
NorESM2-MM ssp245 True True False False
ssp370 True True False False
ssp585 True True True False
DD1mm ACCESS-CM2 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
AWI-CM-1-1-MR ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
CNRM-CM6-1 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
EC-Earth3 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
GFDL-ESM4 ssp245 True True False False
ssp370 True True True False
ssp585 True True True False
MMM ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
NorESM2-MM ssp245 True True False False
ssp370 True True False False
ssp585 True True True False
DTR ACCESS-CM2 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
AWI-CM-1-1-MR ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
CNRM-CM6-1 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
EC-Earth3 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
GFDL-ESM4 ssp245 True True False False
ssp370 True True True False
ssp585 True True True False
MMM ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
NorESM2-MM ssp245 True True False False
ssp370 True True False False
ssp585 True True True False
FD ACCESS-CM2 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
AWI-CM-1-1-MR ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
CNRM-CM6-1 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
EC-Earth3 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
GFDL-ESM4 ssp245 True True False False
ssp370 True True True False
ssp585 True True True False
MMM ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
NorESM2-MM ssp245 True True False False
ssp370 True True False False
ssp585 True True True False
GDD10 ACCESS-CM2 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
AWI-CM-1-1-MR ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
CNRM-CM6-1 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
EC-Earth3 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
GFDL-ESM4 ssp245 True True False False
ssp370 True True True False
ssp585 True True True False
MMM ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
NorESM2-MM ssp245 True True False False
ssp370 True True False False
ssp585 True True True False
GDD5 ACCESS-CM2 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
AWI-CM-1-1-MR ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
CNRM-CM6-1 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
EC-Earth3 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
GFDL-ESM4 ssp245 True True False False
ssp370 True True True False
ssp585 True True True False
MMM ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
NorESM2-MM ssp245 True True False False
ssp370 True True False False
ssp585 True True True False
HD18 ACCESS-CM2 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
AWI-CM-1-1-MR ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
CNRM-CM6-1 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
EC-Earth3 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
GFDL-ESM4 ssp245 True True False False
ssp370 True True True False
ssp585 True True True False
MMM ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
NorESM2-MM ssp245 True True False False
ssp370 True True False False
ssp585 True True True False
PEDsrad ACCESS-CM2 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
AWI-CM-1-1-MR ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
CNRM-CM6-1 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
EC-Earth3 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
GFDL-ESM4 ssp245 True True False False
ssp370 True True True False
ssp585 True True True False
MMM ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
NorESM2-MM ssp245 True True False False
ssp370 True True False False
ssp585 True True True False
PR ACCESS-CM2 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
AWI-CM-1-1-MR ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
CNRM-CM6-1 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
EC-Earth3 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
GFDL-ESM4 ssp245 True True False False
ssp370 True True True False
ssp585 True True True False
MMM ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
NorESM2-MM ssp245 True True False False
ssp370 True True False False
ssp585 True True True False
R99pVAL ACCESS-CM2 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
AWI-CM-1-1-MR ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
CNRM-CM6-1 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
EC-Earth3 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
GFDL-ESM4 ssp245 True True False False
ssp370 True True True False
ssp585 True True True False
MMM ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
NorESM2-MM ssp245 True True False False
ssp370 True True False False
ssp585 True True True False
RR1mm ACCESS-CM2 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
AWI-CM-1-1-MR ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
CNRM-CM6-1 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
EC-Earth3 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
GFDL-ESM4 ssp245 True True False False
ssp370 True True True False
ssp585 True True True False
MMM ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
NorESM2-MM ssp245 True True False False
ssp370 True True False False
ssp585 True True True False
RR25mm ACCESS-CM2 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
AWI-CM-1-1-MR ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
CNRM-CM6-1 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
EC-Earth3 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
GFDL-ESM4 ssp245 True True False False
ssp370 True True True False
ssp585 True True True False
MMM ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
NorESM2-MM ssp245 True True False False
ssp370 True True False False
ssp585 True True True False
T ACCESS-CM2 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
AWI-CM-1-1-MR ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
CNRM-CM6-1 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
EC-Earth3 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
GFDL-ESM4 ssp245 True True False False
ssp370 True True True False
ssp585 True True True False
MMM ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
NorESM2-MM ssp245 True True False False
ssp370 True True False False
ssp585 True True True False
TN ACCESS-CM2 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
AWI-CM-1-1-MR ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
CNRM-CM6-1 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
EC-Earth3 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
GFDL-ESM4 ssp245 True True False False
ssp370 True True True False
ssp585 True True True False
MMM ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
NorESM2-MM ssp245 True True False False
ssp370 True True False False
ssp585 True True True False
TNn ACCESS-CM2 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
AWI-CM-1-1-MR ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
CNRM-CM6-1 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
EC-Earth3 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
GFDL-ESM4 ssp245 True True False False
ssp370 True True True False
ssp585 True True True False
MMM ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
NorESM2-MM ssp245 True True False False
ssp370 True True False False
ssp585 True True True False
TX ACCESS-CM2 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
AWI-CM-1-1-MR ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
CNRM-CM6-1 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
EC-Earth3 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
GFDL-ESM4 ssp245 True True False False
ssp370 True True True False
ssp585 True True True False
MMM ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
NorESM2-MM ssp245 True True False False
ssp370 True True False False
ssp585 True True True False
TX25 ACCESS-CM2 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
AWI-CM-1-1-MR ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
CNRM-CM6-1 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
EC-Earth3 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
GFDL-ESM4 ssp245 True True False False
ssp370 True True True False
ssp585 True True True False
MMM ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
NorESM2-MM ssp245 True True False False
ssp370 True True False False
ssp585 True True True False
TX30 ACCESS-CM2 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
AWI-CM-1-1-MR ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
CNRM-CM6-1 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
EC-Earth3 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
GFDL-ESM4 ssp245 True True False False
ssp370 True True True False
ssp585 True True True False
MMM ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
NorESM2-MM ssp245 True True False False
ssp370 True True False False
ssp585 True True True False
TXx ACCESS-CM2 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
AWI-CM-1-1-MR ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
CNRM-CM6-1 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
EC-Earth3 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
GFDL-ESM4 ssp245 True True False False
ssp370 True True True False
ssp585 True True True False
MMM ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
NorESM2-MM ssp245 True True False False
ssp370 True True False False
ssp585 True True True False
Wd10 ACCESS-CM2 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
AWI-CM-1-1-MR ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
CNRM-CM6-1 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
EC-Earth3 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
GFDL-ESM4 ssp245 True True False False
ssp370 True True True False
ssp585 True True True False
MMM ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
NorESM2-MM ssp245 True True False False
ssp370 True True False False
ssp585 True True True False
Wd99pVAL ACCESS-CM2 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
AWI-CM-1-1-MR ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
CNRM-CM6-1 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
EC-Earth3 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
GFDL-ESM4 ssp245 True True False False
ssp370 True True True False
ssp585 True True True False
MMM ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
NorESM2-MM ssp245 True True False False
ssp370 True True False False
ssp585 True True True False
hurs ACCESS-CM2 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
AWI-CM-1-1-MR ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
CNRM-CM6-1 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
EC-Earth3 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
GFDL-ESM4 ssp245 True True False False
ssp370 True True True False
ssp585 True True True False
MMM ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
NorESM2-MM ssp245 True True False False
ssp370 True True False False
ssp585 True True True False
rsds ACCESS-CM2 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
AWI-CM-1-1-MR ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
CNRM-CM6-1 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
EC-Earth3 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
GFDL-ESM4 ssp245 True True False False
ssp370 True True True False
ssp585 True True True False
MMM ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
NorESM2-MM ssp245 True True False False
ssp370 True True False False
ssp585 True True True False
sfcWind ACCESS-CM2 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
AWI-CM-1-1-MR ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
CNRM-CM6-1 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
EC-Earth3 ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
GFDL-ESM4 ssp245 True True False False
ssp370 True True True False
ssp585 True True True False
MMM ssp126 True True False False
ssp245 True True False False
ssp370 True True True False
ssp585 True True True True
NorESM2-MM ssp245 True True False False
ssp370 True True False False
ssp585 True True True False

The dimensions and coordinates used for the variables are:

Latitude and Longitude represent the coordinates of grid squares of approximately 5 km^2 in area over a rectangular extent covering all New Zealand. The centroids of grid squares over the New Zealand land mass align with NIWA’s Virtual Climate Station Network grids [1] and [2]. Of the 63,180 grid points, only 11,491 cover VCSNs. Only these coordinates have data for the climate variables.

The Date/Times provided in each file represent the mid-point of the respective base or future time period, and in the case of global warming levels, the date/time has no meaning.

Each combination of variables and dimensions is provided as an individual file in a nested directory based on variable ID. The variable and dimension attributes are encoded in the file name. The following lists examples of the naming convention, however file references and variable attributes are also provided in a csv format.

TX30_historical_MMM_CCAM_base_bp1995-2014_ANN_NZ5km.nc

PR_ssp126_MMM_CCAM_change_fp2080-2099_bp1995-2014_SON_NZ5km.nc

T_ssp245_MMM_CCAM_change_wl2_bp1986-2005_JJA_NZ5km.nc