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:27] – [Trunk result files for download by revision] gocht | getting_started_with_capri [2022/07/15 12:46] – [Trunk result files for download by revision] 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.7, 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 **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. | ||
+ | - 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 | + | Compiling |
- | '' | + | |
- | '' | + | |
- | + | ||
- | {{:: | + | |
- | + | ||
- | Those are created by tasks executable | + | |
- 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.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 196: | Line 233: | ||
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