Skip to content

Commit 8b227f4

Browse files
committed
Revert wrong automatic Commit d25b046
1 parent d25b046 commit 8b227f4

14 files changed

Lines changed: 33 additions & 36 deletions

.github/workflows/deploy-docs.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ on:
55
branches:
66
- main
77
paths:
8-
- 'docs/**'
8+
- 'documentation/wiki/**'
99
- 'mkdocs.yml'
1010
workflow_dispatch:
1111

.gitignore

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -246,5 +246,3 @@ input/EUROMODoutput/baseline/*
246246

247247
# IntelliJ
248248
.idea/
249-
.DS_Store
250-
**/.DS_Store

.idea/.gitignore

Lines changed: 0 additions & 10 deletions
This file was deleted.

.idea/copilot.data.migration.agent.xml

Lines changed: 0 additions & 6 deletions
This file was deleted.

.idea/copilot.data.migration.ask2agent.xml

Lines changed: 0 additions & 6 deletions
This file was deleted.

.idea/copilot.data.migration.edit.xml

Lines changed: 0 additions & 6 deletions
This file was deleted.

README.md

Lines changed: 30 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,40 @@
11
# SimPaths
22

3+
by Matteo Richiardi, Patryk Bronka, Justin van de Ven
4+
35
## What is SimPaths and how to use it?
46

57
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.
68

79
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.
810

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).
1038

1139
<!-- 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. -->
1240

@@ -115,4 +143,4 @@ In our open-source project, we follow a clear and consistent branch naming conve
115143
- `docs/documentation-topic`: Prefix documentation branches with `docs` for updating or creating documentation. For example, `docs/update-readme`.
116144
117145
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+
-->

input/.DS_Store

-8 KB
Binary file not shown.

input/InitialPopulations/.DS_Store

-8 KB
Binary file not shown.

mkdocs.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,8 @@ site_url: https://centreformicrosimulation.github.io/SimPaths/
66
repo_url: https://github.com/centreformicrosimulation/SimPaths
77
repo_name: centreformicrosimulation/SimPaths
88

9+
docs_dir: documentation/wiki
10+
911
copyright: >-
1012
Copyright &copy; Matteo Richiardi, Patryk Bronka, Justin van de Ven —
1113
Centre for Microsimulation and Policy Analysis

0 commit comments

Comments
 (0)