getting_started_with_capri
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
getting_started_with_capri [2020/10/04 15:33] – [Trunk result files for download by revision] gocht | getting_started_with_capri [2022/07/15 13:05] – [4. Adjust the settings to your computer] gocht | ||
---|---|---|---|
Line 1: | Line 1: | ||
======Getting started with CAPRI====== | ======Getting started with CAPRI====== | ||
+ | |||
+ | ===== Installing CAPRI Stable Release 2 and earlier ===== | ||
+ | |||
+ | CAPRI Stable Release (STAR) 2 and earlier releases are published with a full set of data, i.e. including all the intermediate data required to build the complete database and produce a calibrated baseline. The model with raw data and the consolidated model database are shipped in two compressed archives. For the latest release, STAR 2.8, they are called " | ||
+ | |||
+ | |||
+ | ==== 1. Ensure that you have Java and GAMS installed on your computer (only required for version until star 2.7) ==== | ||
+ | See [[getting_started_with_capri# | ||
+ | Note: CAPRI version star 2.8 includes a GAMS version and a java version in the package (STAR_2.8.zip). No installation of gams or java is required. | ||
+ | |||
+ | |||
+ | ==== 2. Download the two archives ==== | ||
+ | Click the links to " | ||
+ | |||
+ | ==== 3. Extract the files to a local hard drive ==== | ||
+ | |||
+ | - Create an installation folder to hold **model source files** on your local hard drive such that the path does not contain spaces. Thus, it will not work to install the model in “My Documents” (path containing space) or on a network drive (the access will be too slow). We call this the "CAPRI system folder" | ||
+ | - Extract the files of the compressed archive with code, e.g. '' | ||
+ | - Extract the files of the compressed archive with data, e.g. '' | ||
+ | |||
+ | The resulting directory structure in your CAPRI system folder should look like this afterwards: | ||
+ | |||
+ | {{: | ||
+ | |||
+ | The directory structure inside the folder '' | ||
+ | |||
+ | {{:: | ||
+ | |||
+ | |||
+ | ==== 4. Adjust the settings to your computer ==== | ||
+ | |||
+ | - Go to the subfolder " | ||
+ | - In the menu **settings**, | ||
+ | * In the first tab: enter your name | ||
+ | * In the second tab: verify that the paths to result and restart folders are set to **../ | ||
+ | * In the third tab: enter the complete path to the GAMS executable. Probably it is something like **../ | ||
+ | * In the fourth tab: do nothing. | ||
+ | * In the final tab: do nothing, or, if you have a programming text editor, enter the path to that editor in the proper field. | ||
+ | - Click “Save in caprinew.ini” and accept the file name suggested for your settings. | ||
+ | - Close the GUI, then start it again (using start_capri.bat), | ||
+ | |||
===== Download the current release ===== | ===== Download the current release ===== | ||
Line 9: | Line 50: | ||
The current release and selected previous releases can be downloaded as compressed (zipped) archives using the links in the following table. Note that the item " | The current release and selected previous releases can be downloaded as compressed (zipped) archives using the links in the following table. Note that the item " | ||
- | ^ Release | + | ** For downloading 2.8 please request a password from alexander.gocht@thuenen.de** |
+ | |||
+ | ^ Release | ||
+ | | STAR 2.8 | Code | [[ ]] | | ||
+ | | ::: | ||
+ | | ::: | ||
+ | | STAR 2.7 | Code | [[https:// | ||
+ | | ::: | ||
+ | | ::: | ||
| STAR 2.6 | Code | [[https:// | | STAR 2.6 | Code | [[https:// | ||
| ::: | | ::: | ||
Line 27: | Line 76: | ||
===== System requirements ===== | ===== System requirements ===== | ||
- | CAPRI requires that you have a windows computer with Java runtime environment (64-bit) | + | CAPRI requires that you have a windows computer with Java and GAMS ([[http:// |
- | ===== Installation instructions | + | Regarding Java: There are some licensing implications when using Oracle' |
- | Using CAPRI requires extensive knowledge of how the system works. Please look out for CAPRI training courses on the page of upcoming events. The following bare-bone instructions may nevertheless be sufficient to get the system up and technically running. | ||
- | - Create an installation folder to hold **model source files** on your local hard drive such that the path does not contain spaces. Thus, it will not work to install the model in “My Documents” (path containing space) or on a network drive (the access will be too slow). | ||
- | - Extract the files of the compressed archive (or checkout from SVN) into the folder you just created. | ||
- | - Go to the subfolder GUI, double-click “start_capri.bat”. That should open the graphical user interface (GUI). If not, something is wrong with your Java-installation. | ||
- | - In the menu **settings**, | ||
- | * In the first tab: enter your name | ||
- | * In the second tab: verify that the paths to result and restart folders are set to **../ | ||
- | * In the third tab: enter the complete path to the GAMS executable. Probably it is something like **c:/ | ||
- | * In the fourth tab: do nothing. | ||
- | * In the final tab: do nothing, or, if you have a programming text editor, enter the path to that editor in the proper field. | ||
- | - Click “Save in caprinew.ini” and accept the file name suggested for your settings. | ||
- | - Initialize the result directory structure by executing the task “Create result and restart directory structure” in the workstep “Installation” by marking those radio-buttons in the GUI and clicking “Start GAMS”. | ||
- | - Close the GUI, then start it again (using start_capri.bat), | ||
===== Build databases and baselines ===== | ===== Build databases and baselines ===== | ||
- | The stable releases are shipped with only input data, but not with any of the consistent model databases | + | The stable releases are shipped with the data needed |
- | - The simpler way is to download the zipped archive from [[https:// | ||
- | - The advanced way is to compile the database yourself from raw data. | ||
- | |||
- | If you download the data as a compressed archive, you decompress the archive and place all the files and folders in the result directory of your capri model installation. For example, assume you installed the model in the directory | ||
- | '' | ||
- | '' | ||
- | |||
- | {{:: | ||
- | Those are created by tasks executable from the GUI. So, now you need to build all databases of CAPRI. This takes a long time. Depending on the hardware you use, it can take up to several days. In order to keep track of all the various settings required for completing all the steps, the release contains a “batch execution file” that instructs the GUI how to carry out a sequence of tasks without intervention of the user. Here is what you need to do: | + | Compiling |
- In the GUI, choose the menu GUI –> Batch execution | - In the GUI, choose the menu GUI –> Batch execution | ||
Line 68: | Line 96: | ||
- Click “Open HTML report” and verify that all steps were completed without errors (RC=0). | - Click “Open HTML report” and verify that all steps were completed without errors (RC=0). | ||
- | The current batch execution file (STAR 2.5) does not take over the path to your GAMS installation as entered in the settings dialogue during installation, | + | The current batch execution file (STAR 2.7) does not take over the path to your GAMS installation as entered in the settings dialogue during installation, |
===== Release notes (cumulative) ===== | ===== Release notes (cumulative) ===== | ||
+ | |||
+ | === STAR 2.8 === | ||
+ | |||
+ | Main update relates to the GUI folder by embedded java/gams version, some more minor issues below: | ||
+ | |||
+ | - empty folder problem with ziped files avoided by includeing void.gdx files in gams/temp and userScen in gams/temp | ||
+ | - scenario for import ban included | ||
+ | - BREXIT mode standard setting in capri_gui_definition.xml | ||
+ | - Edits to avoid non unique names in controls in capri_gui_definition.xml | ||
+ | - Inflation_and_trend_interpolation.gms adjusted that also comi prices can be simulated | ||
+ | - batch file adjusted in FAO split into two separate tasks as in the trunk to improve stability | ||
+ | |||
+ | === STAR 2.7 === | ||
+ | |||
+ | Most importantly, | ||
+ | |||
+ | * Priors missing in GHG emission trend estimation now exist (again?) | ||
+ | * The fallback structure for missing nutrient balance data in West Balkan and Turkey taken over from Trunk. | ||
+ | * Import surge of cheese in market baseline prevented by adjusted bounds widening. This problem does not seem to exist in trunk. | ||
+ | * FAOSTAT bug fixed (exportGUI task failed) | ||
=== STAR 2.6 === | === STAR 2.6 === | ||
Line 195: | Line 244: | ||
already in various projects, but the modifications need to be consolidated and integrated into a maintenance release. Similar improvements have accumulated | already in various projects, but the modifications need to be consolidated and integrated into a maintenance release. Similar improvements have accumulated | ||
in the areas of market model tariff data and greenhouse gas emissions, also foreseen to be integrated in a future maintenance release, after thorough testing. | in the areas of market model tariff data and greenhouse gas emissions, also foreseen to be integrated in a future maintenance release, after thorough testing. | ||
- | |||
- | ===== Trunk result files for download by revision ===== | ||
- | |||
- | ^ Result folder zip | ||
- | |{{: | ||
- | --- // | ||
getting_started_with_capri.txt · Last modified: 2022/11/07 10:23 by 127.0.0.1