-
Notifications
You must be signed in to change notification settings - Fork 2
/
Components description and instructions to configure and run the EUROMOD source code.txt
62 lines (49 loc) · 5.56 KB
/
Components description and instructions to configure and run the EUROMOD source code.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
EUROMOD (website: https://euromod-web.jrc.ec.europa.eu/ contact: [email protected] ) is a tax-benefit microsimulation model for the European Union that enables researchers and policy analysts to calculate, in a comparable manner, the effects of taxes and benefits on household incomes and work incentives for the population of each country and for the EU as a whole.
EUROMOD comprises a user interface, an executable, plugins and a specific file structure. This repository includes the source code of the software (user interface, executable, plugins and some additional libraries and files).
In the development of EUROMOD, DevExpress (https://www.devexpress.com/) (WINFORMS version 14.2.4) was used to develop the user interface (EM_UI) and plugins (EM_Plugins).
Devexpress libraries are not open source and every software developer who uses Devexpress products in a design time environment (IDE) must acquire a licence.
As a result, while DevExpress libraries are needed to compile the user interface and plugins, they have not been included in the open source distribution of EUROMOD.
Instead, a licence for its use and the needed files should be obtained directly from DevExpress if you wish to compile these elements.
Elements included in the EUROMOD software source code:
- EM_Executable: Source code of the EM3 executable (EUROMOD calculator engine EM3).
- EM_Executable
- EM_ExecutableCaller
- EM_Transformer
- EuromodHelp: EUROMOD help files.
- EM_Libraries: Libraries which are used in other components.
- EM_Plugins:
- Hypothetical Household: The Hypothetical Household Tool (HHoT) is a EUROMOD plugin for designing hypothetical households and generating data according to the chosen household characteristics.
This hypothetical household data can then be used to estimate the effects of taxes and benefits on household disposable income.
- Income List Components: The Income List Components plugin extracts information about the income lists used in the selected countries/years. In particular, it visualises the components of the income list.
- VariablesChecker: The Variables Checker plugin provides methods for validating the EUROMOD variables file.
- Web Statistics: it generates summary tables with the baseline estimates on the distribution of different income components (from market income to disposable income)
as well as on the incidence of taxes and benefits across decile income groups. It also provides summary statistics on income inequality and poverty indicators, as well as on marginal effective tax rates.
- EM_UI: EUROMOD user interface.
- Executable: Source code of the EM2 executable (EUROMOD calculator engine EM2).
- externallibs: Ionic.Zip.dll (and Readme.txt) which are used in EUROMOD.
- Supporting Material: XML templates that are used by the HHoT, PET and Statistics presenter plugins.
- vcapi: plugin which allows EUROMOD developers to connect to a dedicated version control server to manage the different versions of the model.
Instructions on how to configure and run the source code:
In order to generate the Help file, Microsoft HTML Help Workshop is needed (https://docs.microsoft.com/en-us/previous-versions/windows/desktop/htmlhelp/microsoft-html-help-downloads).
This software is not open source and it is not provided together with EUROMOD.
- Clone the repository.
- Make sure a valid version of DevExpress is installed in the machine.
- Generate the EUROMOD help file (otherwise EUROMOD will display an error). In order to do so:
1. Create a folder named "bin" in \EM_UI.
2. Create a folder named "help" in \EM_UI\bin\
3. Double click on the file \EM_HELP\HelpStructure\AutoRunHelpMaker.xlsm. This file contains a macro which will be automatically run when opening the files. Macros should be enabled.
This macro will create the EUROMOD help in the folder \EM_UI\bin\help which has been previously created.
The macro will use Microsoft HTML Help Workshop and it will expect it to be installed in
C:\Program Files (x86)\HTML Help Workshop\hhc.exe. This software is property of Microsoft and it is not provided together with EUROMOD.
- Generate the In-depth help file (otherwise EUROMOD will display an error). In order to do so:
1. Create a folder named "bin" in \EM_UI (if it does not exist).
2. Create a folder named "help" in \EM_UI\bin\ (if it does not exist)
3. Open the “InDepthHelpMaker” project in Visual Studio, build it and execute it. This will use the existing source files in “EuromodHelp\InDepthHelpMaker\” to generate the “In-depthAnalysisHelp.chm” file in the same folder. Once the help file is generated, you will need to manually move it in “\EM_UI\bin\help\”.
This project will use Microsoft HTML Help Workshop and it will expect it to be installed in C:\Program Files (x86)\HTML Help Workshop\hhc.exe. This software is property of Microsoft and it is not provided together with EUROMOD.
- Double click on the solution file EUROMOD development.sln to open the solution.
- Build the solution by selecting the Solution Configuration Debug and EM_UI.
- Start the solution.
Notes:
- In order to run the previous version of EUROMOD (EM2), the project under \Executable\core-executable needs to be compiled and the EUROMOD.exe
file needs to be copied to \EM_UI\bin\x64\executable.
- In order to use Statistics presenter, the templates from \Supporting Material\EM Templates\UserSelectable need to be copied to C:\ProgramData\EUROMOD\UserSelectableTemplates (folder "UserSelectableTemplates" needs to be created first).