|
1 | 1 | # SimPaths |
2 | 2 |
|
| 3 | +by Matteo Richiardi, Patryk Bronka, Justin van de Ven |
| 4 | + |
3 | 5 | ## What is SimPaths and how to use it? |
4 | 6 |
|
5 | 7 | SimPaths is an open-source framework for modelling individual and household life course events across multiple domains. The framework projects life histories over time, developing detailed representations of career paths, family and intergenerational relationships, health, and financial circumstances. As a family of models, SimPaths offers a dynamic simulation of how life events evolve and interact within populations. |
6 | 8 |
|
7 | 9 | SimPaths models currently exist for the UK, Greece, Hungary, Italy, and Poland. This page refers to the UK model; the other European models are available at the corresponding [SimPathsEU](https://github.com/centreformicrosimulation/SimPathsEU) page. |
8 | 10 |
|
9 | | -The entire SimPaths documentation is available on its [WikiPage](https://github.com/centreformicrosimulation/SimPaths/wiki), which includes: a detailed description of its building blocks; instructions on how to set up and run the model; information about contributing to the model's development. For the web based version [click here](https://centreformicrosimulation.github.io/SimPaths/) |
| 11 | +The entire SimPaths documentation is available on its [website](https://centreformicrosimulation.github.io/SimPaths/), which includes: a detailed description of its building blocks; instructions on how to set up and run the model; information about contributing to the model's development. |
| 12 | + |
| 13 | +## Quick start |
| 14 | + |
| 15 | +### Prerequisites |
| 16 | + |
| 17 | +- Java 19 |
| 18 | +- Maven 3.8+ |
| 19 | +- Optional IDE: IntelliJ IDEA (import as a Maven project) |
| 20 | + |
| 21 | +### Build and run |
| 22 | + |
| 23 | +```bash |
| 24 | +mvn clean package |
| 25 | +java -jar multirun.jar -DBSetup |
| 26 | +java -jar multirun.jar |
| 27 | +``` |
| 28 | + |
| 29 | +The first command builds the JARs. The second creates the H2 donor database from the input data. The third runs the simulation using `default.yml`. |
| 30 | + |
| 31 | +To use a different config file: |
| 32 | + |
| 33 | +```bash |
| 34 | +java -jar multirun.jar -config my_run.yml |
| 35 | +``` |
| 36 | + |
| 37 | +For configuration options, see the annotated `config/default.yml`. For the data pipeline and further reference, see [`documentation/`](documentation/README.md). |
10 | 38 |
|
11 | 39 | <!-- Projections for a workhorse model parameterised to the UK context are reported in [Bronka, P. et al. (2023). *SimPaths: an open-source microsimulation model for life course analysis* (No. CEMPA6/23), Centre for Microsimulation and Policy Analysis at the Institute for Social and Economic Research*](https://www.microsimulation.ac.uk/publications/publication-557738/), which closely reflect observed data throughout a 10-year validation window. --> |
12 | 40 |
|
@@ -115,4 +143,4 @@ In our open-source project, we follow a clear and consistent branch naming conve |
115 | 143 | - `docs/documentation-topic`: Prefix documentation branches with `docs` for updating or creating documentation. For example, `docs/update-readme`. |
116 | 144 |
|
117 | 145 | These branch naming conventions are designed to make it easy for our contributors to understand the purpose of each branch and maintain consistency within our repository. Please adhere to these conventions when creating branches for your contributions. |
118 | | ---> |
| 146 | +--> |
0 commit comments