Skip to main content

WiNDC Model

Downloads
WiNDC Buildstream Package WiNDC Buildstream Package (13 MB)

Release Notes

Currently, the datasets and build routine are available for the energy-environment module, called blueNOTE, and a basic agricultural model, labeled "nass".

  1. Download and unzip the build package from the link above.
  2. Unzipping the file will create a directory called windc with the subdirectories build and gdx-in, and the GAMS file run.gms. The directory build contains all subroutines and the directory gdx-in contains the datasources in GDX format.
  3. If you have a local version of GAMS and have access to the relevant licenses, navigate in your command line or terminal to the windc directory and run the GAMS file run.gms by simply typing the following command:
    gams run.gms
    Note that this build will work in both, Windows and UNIX/LINUX environments. See the paper for a description of all subroutines within the build stream.
  4. The core WiNDC database, WiNDCdatabase.gdx, will be generated locally in a directory called datasets. It contains data for all US states and 71 (summary) sectors from 1997-2014.
  5. If you don't have access to a GAMS license including needed solver licenses, you can generate the database locally by using NEOS. Please contact us for detailed instructions.
  6. Once the database is created, it can be loaded into a general equilibrium model in GAMS. Note that accounting models are included in the build distribution which can be used as starting points for model formulation. If a dataset is generated without any optional recalibration, it includes data for all years. Here is an example of how to read the core data file into GAMS in a simple general equilibrium model and verify benchmark consistency in the underlying dataset. Note that this model contains no customizations aside from sectoral aggregation.

Notes

  1. You can modify the build stream to produce a specific module or select only data for a specific year.
    For example, the following command will generate a dataset consistent with the blueNOTE module:
    gams run.gms --satdata=bluenote
    Alternatively, the option --satdata=nass will generate the dataset for the agricultural module.
    To select a specific year, use the following command:
    gams run.gams --year=2014
    A dataset will be generated with only the data for the year 2014. Note that all years from 1997 to 2014 can be selected.
  2. In addition, you can modify the build stream to produce a disaggregated dataset. After generating or downloading the core WiNDC database, choose one of the following three options:
    gams run.gams --aggr=389
    This will disagreggate the 71 summary sectors in the database into 389 sectors.
    gams run.gams --aggr=bluenote
    This will disagreggate the data relating to blueNOTE without recalibrating (as opposed to to satdata=bluenote, which recalibrates the data).
    gams run.gams --aggr=nass
    This will disagreggate the data relating to the agricultural module without recalibrating (as opposed to to satdata=nass, which recalibrates the data).

Version Information

  • Release Date: December 01, 2018
  • Data Version: v1.0.0