From 8b227f4b88deeb1b15d23b2c79542e7eaf8bc42a Mon Sep 17 00:00:00 2001
From: dav-sonn <62243276+dav-sonn@users.noreply.github.com>
Date: Tue, 17 Mar 2026 14:08:29 +0000
Subject: [PATCH 1/2] Revert wrong automatic Commit d25b046

---
 .github/workflows/deploy-docs.yml          |   2 +-
 .gitignore                                 |   2 --
 .idea/.gitignore                           |  10 -------
 .idea/copilot.data.migration.agent.xml     |   6 ----
 .idea/copilot.data.migration.ask2agent.xml |   6 ----
 .idea/copilot.data.migration.edit.xml      |   6 ----
 README.md                                  |  32 +++++++++++++++++++--
 input/.DS_Store                            | Bin 8196 -> 0 bytes
 input/InitialPopulations/.DS_Store         | Bin 8196 -> 0 bytes
 mkdocs.yml                                 |   2 ++
 requirements.txt                           |   3 --
 src/.DS_Store                              | Bin 8196 -> 0 bytes
 src/main/.DS_Store                         | Bin 8196 -> 0 bytes
 src/main/java/.DS_Store                    | Bin 8196 -> 0 bytes
 14 files changed, 33 insertions(+), 36 deletions(-)
 delete mode 100644 .idea/.gitignore
 delete mode 100644 .idea/copilot.data.migration.agent.xml
 delete mode 100644 .idea/copilot.data.migration.ask2agent.xml
 delete mode 100644 .idea/copilot.data.migration.edit.xml
 delete mode 100644 input/.DS_Store
 delete mode 100644 input/InitialPopulations/.DS_Store
 delete mode 100644 requirements.txt
 delete mode 100644 src/.DS_Store
 delete mode 100644 src/main/.DS_Store
 delete mode 100644 src/main/java/.DS_Store

diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml
index af12673ff..66dce2744 100644
--- a/.github/workflows/deploy-docs.yml
+++ b/.github/workflows/deploy-docs.yml
@@ -5,7 +5,7 @@ on:
     branches:
       - main
     paths:
-      - 'docs/**'
+      - 'documentation/wiki/**'
       - 'mkdocs.yml'
   workflow_dispatch:
 
diff --git a/.gitignore b/.gitignore
index 0fc7540ea..a558e809f 100644
--- a/.gitignore
+++ b/.gitignore
@@ -246,5 +246,3 @@ input/EUROMODoutput/baseline/*
 
 # IntelliJ
 .idea/
-.DS_Store
-**/.DS_Store
diff --git a/.idea/.gitignore b/.idea/.gitignore
deleted file mode 100644
index ab1f4164e..000000000
--- a/.idea/.gitignore
+++ /dev/null
@@ -1,10 +0,0 @@
-# Default ignored files
-/shelf/
-/workspace.xml
-# Ignored default folder with query files
-/queries/
-# Datasource local storage ignored files
-/dataSources/
-/dataSources.local.xml
-# Editor-based HTTP Client requests
-/httpRequests/
diff --git a/.idea/copilot.data.migration.agent.xml b/.idea/copilot.data.migration.agent.xml
deleted file mode 100644
index 4ea72a911..000000000
--- a/.idea/copilot.data.migration.agent.xml
+++ /dev/null
@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="AgentMigrationStateService">
-    <option name="migrationStatus" value="COMPLETED" />
-  </component>
-</project>
\ No newline at end of file
diff --git a/.idea/copilot.data.migration.ask2agent.xml b/.idea/copilot.data.migration.ask2agent.xml
deleted file mode 100644
index 1f2ea11e7..000000000
--- a/.idea/copilot.data.migration.ask2agent.xml
+++ /dev/null
@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="Ask2AgentMigrationStateService">
-    <option name="migrationStatus" value="COMPLETED" />
-  </component>
-</project>
\ No newline at end of file
diff --git a/.idea/copilot.data.migration.edit.xml b/.idea/copilot.data.migration.edit.xml
deleted file mode 100644
index 8648f9401..000000000
--- a/.idea/copilot.data.migration.edit.xml
+++ /dev/null
@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="EditMigrationStateService">
-    <option name="migrationStatus" value="COMPLETED" />
-  </component>
-</project>
\ No newline at end of file
diff --git a/README.md b/README.md
index 853823b15..bf5c76ffe 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,40 @@
 # SimPaths
 
+by Matteo Richiardi, Patryk Bronka, Justin van de Ven
+
 ## What is SimPaths and how to use it?
 
 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.
 
 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. 
 
-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/)
+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.
+
+## Quick start
+
+### Prerequisites
+
+- Java 19
+- Maven 3.8+
+- Optional IDE: IntelliJ IDEA (import as a Maven project)
+
+### Build and run
+
+```bash
+mvn clean package
+java -jar multirun.jar -DBSetup
+java -jar multirun.jar
+```
+
+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`.
+
+To use a different config file:
+
+```bash
+java -jar multirun.jar -config my_run.yml
+```
+
+For configuration options, see the annotated `config/default.yml`. For the data pipeline and further reference, see [`documentation/`](documentation/README.md).
 
 <!-- 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. -->
 
@@ -115,4 +143,4 @@ In our open-source project, we follow a clear and consistent branch naming conve
     - `docs/documentation-topic`: Prefix documentation branches with `docs` for updating or creating documentation. For example, `docs/update-readme`.
 
 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.
--->
+-->
\ No newline at end of file
diff --git a/input/.DS_Store b/input/.DS_Store
deleted file mode 100644
index b3a2ac00096e3dfec35823a6dca632962cfd239d..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 8196
zcmeHMYitx%6u#fI&>70eKzS69?dYO_R%|I0fdWe(N_myA+b2k!-5uzp)0w(6+bv*|
z5)~6L#%MJD@J-?`gQC%x7<?pZ2t-W`F@naJ_`?|DA0z(ZkLS*vEw<Q%1T`4vCUeid
z=brE0IcM*8@19-87#j20TE;3FV=_HlYUNb@Md9Q8xvEH^rj#TI&zQvwX0x5lWrJ5)
zM~Wx{Q3Rq0L=lK05JlidhydN$yvUQ>`(iYzqX<M1_+LhVpAR}cTqZ&}Dr9hUP!*&A
zBzX!D6lzl*5McCBCPFzXWB{c(MfQLYiZI21fYZ3n%}FLgIVz-pGYB|CxH7^F1;Ofs
z(*tvcgpg4kMIeg6)e+$InZ;U}L%F*@E`QHcCT|2fmqxvG!5d85Zkp`hOAp$X=hxJH
z4XLDb%G5HsOfHx2PxiTmq;L3nuhGcu=Dn2b+Ua83NOxFfp;w#T<T}1#Ic6>ZSXq-y
z_H<fK)-5!;c_-@y*rXVc6<O)kDi0l6xvHjGuUlO|Qmr3avx3?y>*_~F6nRek?sdC*
z`|Sb8Ju2KoctkLDg1g7A)mPgaY7)Mdq>H|OTl7_#Rz6+5Dc059vwM%)(`98`Cutot
zd$k!Jx!g+KojG%eT<y%bc7DL|dbODu!_MSw!#6kCHa8~SEN;>^=v%Jib(lGiB%dOa
zb8UO4>sfrDyURC+{o?H7hPrw@H|IA6EA(nw-ZOWZw172aHq$a*k1?DIq47kGh=X!s
zMx}n+vgLL6tlxC+mL0p!X)|Y4sOsE#okNyqrERm@@G_>8wVeI!1uN_K_0UJ)_|`tl
z%qhxDRHqzcz&uwmf5F0=7sX=2<_e}bOIJQ^J(#!r16o{`#Tv2rVnx>8*^{ML+wNxh
zjM-o$7K<;H<=tH0lryOoYBg4U7XgfvN3jZDvv!4|XkMzH_KAS1^{Zt?%eLD_+O$K}
zx&~5h?Hm&E43%>eveK1t2L{L)Pv~OJEwZeg-pd!>W_W(vpy`agQgf>;_jr9q&TK2t
zE-fOq%X07;lb%CbvX<}Wf@rkGW3g^N)uwFL%#za!=P#&;rD7ej_7!0?%NeqW7xaM&
zddRaUY)r(9ig@A<(Tso8FB(D66}la(*iyEZHL?!Y&qml0_8dFT-en)NGwdw8z<y*G
z*(G)vQ&9#P<<Kx6Rak~vtVILXV*~EPX0&1}x?muU3|tK301o0I9L7-`!{c}YPvd#K
zfEV#HUc(!B6DRRD-p42S6rbTse1r42fbVb-zu^*ommp1(%BAU2Oj;t<N-Lx~sX<yV
zZIlvHQc6jt<VXc+RC-kSAr)D<x9DrAKSJ`FP9S1scmheMCSj$%xpm9dZR(c)5-ZQo
z;5?i?XYRbpTW-IzX4RSvjbpo2Z0_QI{xeSkYK$XPK#gFxOx)H1Vbv<Vow#ETUtz3Z
zaFMrK8Rxisj$7ZVF4nav#4gcYqAt_5sl+VNt=5<8nnZ*a-CDg))k=u2N`S4`m#Z3N
z(OIiDs9GrzS9CY3RjS4m(P`3KbdA$c{`(2>J^P9M!Y%<shze9<5vs8Y>(D|3NTMAb
z=td8bz{EcE!9or`@+c4`4&z}wf+KhgPvR*e#4~snFX0uuisN`4Cx{j&@fMNd6h6R*
zIE^zni_h@|(c=gFj9+m%{9?++HvEnW8=e#4nl}7UGUwQ?v!CpX<QYHJb@oaGzLMwv
zEtCKLf1RsD@F)UN1a9OAptL#J+(>UY*(t-1G@YIY=;4LijS3k+s0vO!l0iC7a_kR7
nYU^amF^N!)3P~C&|N0LBH`=%I=>CuH|L`yK2`TqKdjJ0cN&&eH

diff --git a/input/InitialPopulations/.DS_Store b/input/InitialPopulations/.DS_Store
deleted file mode 100644
index 499b98c7e2220774f6e51b0d1dcc1238821e099c..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 8196
zcmeHMZEO@p7@lWa=q_btp?nmO>*}F^R%|I0fg(pgl=4-=T|YtU-rdq}y4|g}d%XfS
zDN!*2V~j@Q55GzLWl%I46N4X#8Uj%hLyVv?CjKyn_{WHU_~Sb}dqrCM4-LefWagcD
zXWp54pL?H~n>)rB8uQs&#wr<OGG#8caw@Koct6jRk`!u6NrLPdbC^ZBFJ174CXJ31
z5dskc5dskc5dskcHv$55XY(Xaaqo-XsEiPZ5cpprz|RMrGM9-^jtLnY9aIEQ0FwL(
z5G1P8J0P&pLzxKWn2>=f%_&|F2u%?_F(AyTU+2R~CPFzTq%da?<_zJ=2wx}&Rwp|>
z7|xIoGAbhkA_OKQ!0971pXHblyxqs&?`hjjQ{RW_A=~o&nwsw*m6T4KUM82x<?=(x
zez%bH4L|QS8o52Zm2zD>U921F4$Ca`YIB=h$2Tm;%moHk)}$eOJ1r;c78>2Wll21I
zr09?pS?Sd(4;@;)rlwl2TU$R`tsh#qit4ND>PJTvd0zb94ZC{>>_NvpDqKN$958i)
zYsaqTm+cKV3BO9xMZbP1`lZY$pQ+vw>+0^=vsdluvNEodv<{lR+ANRUYo+F{oH<Nx
zb!J>UKj?V9+U$&BXY#h;o11N$4<_9lKBR5Pw_L~TFmoPBK1C+y+V(Ejvv@~$mv4^v
z#o4dw>gw^_oZl3z(5q>A&)jX&0@kqEOv`vZ#z-nOjVEe^&&r8emHHhkR@U9Oaq|OP
zckVu?&7M=Cs`D3g4qKj;w#{zC%a~5qa{Af}R@U$DA-Emi+HaXTMVXE2lw%B<=PDL1
zT72u0SWJw$VpE)@E1$L=$y@#bEiTJqjaYoCB5UvO&C=F(xLH19Ht31P;>%@u57#&4
zOe%$1jaA=621d#wtio;9u2K}uOASy=2vfCwt*mI-cH2mscBtCWK&ow>!vfDxIX@vQ
zT^V<9keu;^F4o*4%i8IEeBtee=eG@+&iIy^TV=V&>o;;{TY)07Xt6_<gU^`s+@vLI
z`ED*iqb(kbb@Qn<XR~IOoL;<eQAI2j>yWi?$wsrBVT(9GAE=;$Ja<A6B3@L)6L*Pf
z{L=wZ2|!nfdsS>XThAI<2OD6c><D|29cLe~&)6AumR(@Ku#4;xyNu~5gN$-$ScodD
zKrPmz0UL2Y9>f;3VjH?(AdL)MjNkwc;!zyNQ5?flcpA^)CA^GR@EYF4+js{j@g6?H
z=lB9&;v0OA^SFQ?aS?yw68@4P&5+8anNmzzCe=!-q&lfV+9++35>ir1Nv7mT1!+ur
zLiiyS8Mv?LYp6d$a?;5{3>*>+luk{-Kz&Q=)@|F>tv3?`&(GqVn>%m*g38<Oyt`)2
zy89c)BU1!&F?RpSiGT)Iktd)*5E&CgI3TB5rMDAL%#kbX6l^VWR4e0rme29gx2sEa
zZ5lC2G?%F>bZt7ZNHnYUmAWPoc}25UuT!-WqNWnq*6S-(4YFvgR~uBVlt?O?o75^*
zV~S`r=`Fg(DJNh5;QxvJ%6?~;01EyJRALFLu?8E^LcyLyJ37#f9twC9`_T^zIrzw<
zK;eHFkKu6~!IO9f&r<L|j~DPNUdJ0aj<;}vC~y+*5&=%(V|;?sID@nJ3SScye#US3
z1DC@umux(^cTNay9`uufdpMbMY}e_dz9K2EHoL)EC1O97{QciD_3!^T*si1PL<mF(
zTu%g0+MH}|q#36=wfJ$UQ+}8-Pkh{%kbwym!HG#Sc#e}C|HF{#It}GEiBOISNg7K3
W`40jA#y9Zj{*Uf|)^}6g|9=C=c#i%6

diff --git a/mkdocs.yml b/mkdocs.yml
index 01e7b975b..31873be04 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -6,6 +6,8 @@ site_url: https://centreformicrosimulation.github.io/SimPaths/
 repo_url: https://github.com/centreformicrosimulation/SimPaths
 repo_name: centreformicrosimulation/SimPaths
 
+docs_dir: documentation/wiki
+
 copyright: >-
   Copyright &copy; Matteo Richiardi, Patryk Bronka, Justin van de Ven —
   Centre for Microsimulation and Policy Analysis
diff --git a/requirements.txt b/requirements.txt
deleted file mode 100644
index 859460728..000000000
--- a/requirements.txt
+++ /dev/null
@@ -1,3 +0,0 @@
-mkdocs>=1.6,<2.0
-mkdocs-material>=9.5,<10.0
-mkdocs-git-revision-date-localized>=1.2.0
diff --git a/src/.DS_Store b/src/.DS_Store
deleted file mode 100644
index 55740b95b2afd6e56456607bd39ef580068ae3ac..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 8196
zcmeHMZEO@p7@lWa=q_btp?nmO>*}F^R%|I0fg(pgl=4-=_47dL-rYhs-R{=gy}JT7
zDN!*2V~j@Q55GzLWl%I46N4X#8Uj%hLyVv?CjKyn_{WHU_~Sb}dj*R9p)p2uCz*L?
z-kEo1-}jzpW@nEvhUR>>p0R4im`s^Vt&)mANW7otYmyXd%1MIkS-R*Ar)@V)?RT#k
z9Vwy+L=lK05Je!0Koo(0Lj>r|=1HF9+!wu38ATw9!2dD=e1Fg>bD0R`n2^ENK}B!{
zAjz))L87|GD<t($CPFzTB=t~&FeNEW5neGM%t^0@;}W496H=HngqIJ5D<iz2AXuH|
z*Ms2<2_d60ia->BYa_tvQ_hB%!7S!nd4Eq2+m`3o)qMr2tbEGU3b{hAl<!LpxW%Mz
z_<66{$nD~-PS>^5rMi*sw#;I`HoL`je8Y0gTwq{jO&YSh$8xf6vDwW#Sue0niVj(k
zm42=I;K7xv>T30d)s3UI`oT3TsJ^nHadcFX=fv+^x3hoH9&+3x!Ucre08=Npbo5Gp
zY_HHFzDJa$Oa6RQ@<*9gIbFRW*4vlbwOdW~S{c_#S_jO2ZH7l~wNrCP&Mc5SJsH=|
z4>?}HHZx<`nY?ZI=0@A*gGo1w59t{8E!Xk7&74P)Pm#&Fw!OpkEZ))A>zgBfY4)qS
zdQ+a8^IL)y`ZX=@nLABdz$%!nw2YTBMmj^&c%n}DsvMtDt>3b2dBa`nH{P>(`_8l4
z%vn{cI(J@A!SbxMZT1;n#&oilv#+aYW&ME^h1v0~y_T6%l$ogQbc`YMY}Nb)3vXN$
zi-|FpZA!EB=F`>#dCT9g#bsHn5sNQYWbN(US$ec>ZkErO4SHg+_)=Nk#q}*YlS-jh
zW3_jXfzjzvtis2vU!f?P*EvX75T<J5YFW{;UAB=n?NGI@iBwy93L>7Na&AIadNc0O
z5IN%sU97cDmbFuR_`+Ka&+iyEo$*I%ZI|VgH(=z<jv^tkWU)<_gWs6++@vjQ`ED+V
zMn^mr>*G^x%x29jIlXZHf~r_&tXtN;Bpc0g3Kn6Xeo#RHdG-YGAzo6%6Ss+K{KG*}
z34*TBDObamvbC(4b+bV>$_}$<*)jGG`-q)pXV`i61G~U3vP+nX3dpF0hWV($GSp)&
zny?;s<6dk+JGP(~2GYpD#R&G}03O649KlgMhR5*~p2PEa0WaZIypA_;0&n3xe2h=<
zDZaqhIEVB278md<F5)){(ln`3nl8npB~rb#LTZqjr1jDUDIq1LPRW!UsVI#}j|e}c
z67%+yd=2%7NsjL%#JuoJpmcH)=INW-H*eXhZoZzFcWwsf+Uz-V=T+Zy>+N-`*4*7Z
zjz|IE5@xUDLID4(NE5(6K*U7o2BcJL^e*CuIdYkmf~6&HY89Nv@>xFmW_7WyO(6z}
z<`Q+8u1zKOh-R(6T-PKbt!UQk4XRc~lvD!SMt!-eK^Bd*YLlv!6FEh5gIc3%Oc9M1
zy-n9R)#Se)^xv@`+0X1EK%lQeH5Q>3tFR7j1o9-h(2YK%2<RsEVgMF$@R3K6V1Eb?
z;b9!cqj&;O66l}CGk6g%;}smkYdB8OKY=$1_$To`KENrQ#u<Eu&xr!x<0t%rOW{i-
z8wd6F383a+9|v_InR9H{*+;q(39cS~owdru^H%fwf7|5W|F1KzqQ{LQ5Jlk6L;&Tj
z$<}7Fm~2<$+oVqUe#$)YabrRTCR7AFDaqhEPICMYL#pdEl-ndiIVL1&DE;Ff0!lCC
Rf91_PI{%~d|37m6{|+0weZc?#

diff --git a/src/main/.DS_Store b/src/main/.DS_Store
deleted file mode 100644
index 4337822cc843ae50a4ec10eb99dc2f821937cc4e..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 8196
zcmeHMZEO@p7@lWa=q_btp?nmO>*}F^R%|I0fdWTAl=4-=^}9&jyIbhm?QXr@yDMOm
z5)~6L#%MJD@SDV621TPWG5C?FArLh&#0VN=;tykpe~kEtKfbfGSD@G*8e>Fvl9_kr
zoq1>WeeZc@cJ>%!Xv}458LMQB$&|U&%BlE+#QS-^CP|^DlqATWr3&6~%63!Ke)pQu
zks^vf6oDuLQ3Rq0L=pHmM1an0p5#f+ebF10Q3Rq0{4XQG_XnLamx)l02^nl1R0LN5
zlKct~B&ut?LQ)T9B9vo7QV%5vQ<B0I;S~eIob-A)E)mKxA%!_Zc=<rMGQt}Qg4Jn$
zJs8fA5Hc#G2t*OMHUgYJrR;uYusk!ayuYW0ZOij(YQBP0QaWX7nOr89%l9S++(Obf
z{G8WlWczrl-F59$v2LU~Ewj+C&2DlX->@7r8yHv_lZNc>vYd=tXmoQ<#tUqdqC-|>
zrC+N&cyQ&anrgjnb^U0yesIkSs;{i8A01WXIq^H!?dl)2haC5aZ~@^qz|;vY9lg>Y
z+sikJ?-3=bqCejh{ZXcsPgie<b@%l4?N)oct+eYTtpjGiHp3&gTB*4+Yv#$FuC#0C
zh8(Y7o0&H3bj~(>bCYfJ!K9nThqMj*mg{((X4WIgr$}dA+urGV7Vqfk_RSH$IQvyy
z-MyZh^_zkf`ZX=*nY&C{z{;D=w2aqljI@WQ@kEXARXIMRQom){^18d$Z@PQSj$LQ9
znX@WXb?&^byyaOb+w3vCwCQ9lXJ1Fb%J>7l6lTY__F86EQD&mL-7$vDvla6fEWB}1
zEGEWWwkgiiol98{<Sc)`7MEqQMl8Nqk+rvXXXw$kyBR)XCg_R9;!9<@kL#PVCY3_1
z#;Wfi1EbxeScQ*SyFyVkuYHiPAWYTz)v}^xI&33l+M#M)1F5!l<wZP0<=lj<bf?{+
zA#%nOx>$3IENiFs@P)S-p5HcXI^&Pj+$zhx-hh!c+X{rlqQ!Pu4t`_ObCZ^g<-6G+
z8g21dtcOpvDU&fX<n+S%3o2smu})e0l58}~$y<bd`auN+<k=Izhj>vDPuwP|@ec<@
zB?!7gr(6|V%GR<**2xChC_BuaWyjb%>?3xXonhzM59|WF$Sz?j${?d08s?)4%TSB8
zXux`Gz&+TER%}H#45W~TixKR{0X&F9ID(^i43Fa}JcsA;0$#$acpY!x1m41X_!yty
zQ+$E1aSrG4EiT|!T*Pk@q-j#QG+l~GOQc$9g;XasNb9AIQbI~f?UE@uQb8J%9ua;>
zMds}(`WosFlN{ekh<V|cK<VTp%+oiwZrQp`-EuuK@7xT|wb^s#&a1rX*4t}Vt=Z5x
zjz|IEB4)4TLID4(NE5(6K*U7o2BcK0^bX>OIdYkmf~7@nYGs_q@>xFmW_7WyO(6z}
z<`Q+8u1zKOh-S6ET-PKbt!UQjb*ffElvD!SdVRU7K^Bd*YJ;kk5;;Y4qgthEOc9MH
zy+zkJ)#Se)^xv@`+0X1EK%lQcB^IF?tFR6&1o9+0(1{-O63|WT#Q-d1;Uk9v!Tt~)
z!oxU>NAU!nB+x&NXYe9k#w$36*KnMme*$k3@K54>e1KCpjWhTRpA!YX$4~eLm%^7w
zHV*0?6F|+uJ`U=9GV9o`vyXH|5?np}I%}1P=dI-T|CY(W|6gZbMUNXrAd0}Bi2zEQ
zlg*7}G1;!hw@IDyeUy3P<Hm#xOsEKUQj)=SoaFc)hE&&SD7Q(3a!g3lQ2NI|1QcJ&
R|H_+pbpA)@|9|BC{~dn$eX;-m

diff --git a/src/main/java/.DS_Store b/src/main/java/.DS_Store
deleted file mode 100644
index acd62f49c0561a5a003876c1fd982a8d22063404..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 8196
zcmeHMZEO@p7@lWa=q_btp?nmO>*}F^R%|I0fdWTAl=4-=T|YtU-rYhs-R{=gy<P#E
zl&F}1F-D{Dhu<XrGAJ62iNTLV4S}eMAx6*`6Mq;({A0vF{PCTgy#g)$hX&$KGV{*7
zGtbPt@4e5=%^hP5jrnXXW0j0CnKGAJIThDQyr1U@NeVTkBtdw_4Cb>w=A{eX;DphU
zBJx1wfye`q2O<wd9=I7iKzBAz@+9}Z=#9$A1Ca;*mmc8fgHD;tL?}mv42}*ef+qk;
z{sagT)#)7&VDwNXLOCjA0Hry_>j5DY;S&P_PW?I`PBIb7Q6UAKLBJWpl@Y#B5Ufr(
zJs8fA5Hczw4@4fA=mAb2nR(1&18nf>_j}rQ)71A-deF8!zozDUNF}9Hrk2TNa=H9)
zvd=9feZ$XtjYe)aZ>3z<P8aJ&y2COHz1r+1*YOR@F>?XH%9=D}Pp9Q%-9n?Acd}l9
zO^Oa#k(FMp^3b7`t7@wCy4Cd~)%u||E2zG*u6|@hk>|wkU$?8b-yU$>qrwz~#{pBv
znRe`YcG=!gld!8KU9{`RqFu_g^6Bbrv99i(-FwuYE-T|YN$a55tIhDpyjE)N%$Y-E
zR%gbw^8=38tIf<9b|!BdzPZV^`C!t`;zQa7eam&c4m0PG<WppFu5IshJ&SjAclqY9
zU!47#uC5->&G}8i3cZ?^_sm@;Enp3q&9scyV+^N4XgpCPY*tRpsMPOTw!H3v^_w2t
zvSZgdZRV^BRh>JpbI9_nv~6}9UdD8?mb1UTU}gQj9&)$iTl*|CrzkT~opOu;^IXOJ
z1q*Lq6pM*5S1`p{y7Fo3(Y)m!(BiTz)`-OyE3)>%o-A!`yPM@RW`mwsEWT8hcXNGH
z&ZJVP)mZg?1Taz_`6}FI?FvQFyi`BMgn+8`t7S#Yw%bP9v_sXp22yS991{Kvm2(ra
z(v@)s2FMss=wi(+vaFrn%NO2ecz)ZU>5OfuxmA{XygnmmwiPHMi-_&A9DK&4=a81H
z<-57S8*TAetea1@DVsI3Wc0%M3o2r%Scj~AM;Og=hAiR$eV~F0^6YUzh<H&EPuwG_
z@z452C2+bz+^b?s*;>}fI#@p&VMo|Y>^S?7ea_CXv+M%<m0e_)*kw#b8Dx}0!+ca>
z8EUZ>4Oov2cnF)(imm8^fiyC3F^mH^h{tdkM{x{K;~6}Um+=Z-#p`$r@8DgW#QXRd
zU*Jo8g>Uf#&f@}p!bSXrOZZ!YG)*d(rb{ttiBv1Ckm{rcX}z>jN=Qj5C7F^V6{Jz=
zNnwXnWZ>SSt)c!1$q6S5F>p{YP&zdU1NF_VTefafx7<n$JU@eTZuXqH^D6JS``(&W
zYc@2FMWzVkV(ebciGT*zkSCx)5E<h`I3TB5rMDAL%;78S6l^VWR4e0rme29gcdCnZ
zZ3;0-G?%E$bZsiJNHnYU<+>&jc}25UuT!-WqNWmH>-FWT23a)Lstu}EN+cD{jcS#u
zF-0_*^cG#?l#_3K@c+zyV}Gzq00n;qDzOOFScP?Hp<qv<9UbUK4+Xr5edvRQ9DL+a
zpzuG8$MFP?;3+(d=P3AJz>9bdZ{STF$J;nT6gY|ZhybVX2|mSXoWWUqjc<qwzu<TL
ziOb=aOEwnVJH`b!5BdqgJ(SEjw(IPtz9K2Eh23PW60x63{{C;7{P+KxY}e6tA`e6!
zxRD+}X>+o<k!GCi)Z)jXPWchaJn?a(LIw~jf)kTu@Ej*O_J<+WbsEYsiBOITNg7K3
V`40jA#y9Zj{*Uf|=G{{F|3BzBk3#?e


From cebb138242cde9c8371e8fc1212f1409bfd998fa Mon Sep 17 00:00:00 2001
From: dav-sonn <62243276+dav-sonn@users.noreply.github.com>
Date: Tue, 17 Mar 2026 14:42:45 +0000
Subject: [PATCH 2/2] Small corrections in some documentation files

---
 README.md                                     | 139 +-----------------
 .../internals/multirun-implementation.md      | 137 +++++++++++++++++
 2 files changed, 139 insertions(+), 137 deletions(-)

diff --git a/README.md b/README.md
index bf5c76ffe..7bf11d49e 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # SimPaths
 
-by Matteo Richiardi, Patryk Bronka, Justin van de Ven
+by CeMPA (Centre for Microsimulation and Policy Analysis).
 
 ## What is SimPaths and how to use it?
 
@@ -8,139 +8,4 @@ SimPaths is an open-source framework for modelling individual and household life
 
 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. 
 
-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.
-
-## Quick start
-
-### Prerequisites
-
-- Java 19
-- Maven 3.8+
-- Optional IDE: IntelliJ IDEA (import as a Maven project)
-
-### Build and run
-
-```bash
-mvn clean package
-java -jar multirun.jar -DBSetup
-java -jar multirun.jar
-```
-
-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`.
-
-To use a different config file:
-
-```bash
-java -jar multirun.jar -config my_run.yml
-```
-
-For configuration options, see the annotated `config/default.yml`. For the data pipeline and further reference, see [`documentation/`](documentation/README.md).
-
-<!-- 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. -->
-
-
-<!--
-## Getting Started
-
-To contribute to this project, you need to fork the repository and set up your development environment.
-
-### Access to Data
-
-We are committed to maintaining transparency and open-source principles in this project. All the code, documentation, and resources related to our project are available on GitHub for you to explore, use, and contribute to.
-
-The data used by this project is not freely shareable. If you are interested in accessing the data necessary to run the simulation, get in touch with the repository maintainers for further instructions.
-
-However, please note that _training_ data is provided. It allows the simulation to be run and developed, but results obtained on the basis of the training dataset should not be interpreted, except for the purpose of training and development. 
-
-**How to Request Access to Data:**
-
-If you have a need for the data, please contact the repository maintainers through the [issue tracker](https://github.com/centreformicrosimulation/SimPaths/issues).
-
-
-### Forking the Repository
-
-1. Click the "Fork" button at the top-right corner of this repository.
-2. Untick the `Copy only the main branch` box.
-3. This will create a copy of the repository in your own GitHub account.
-4. Follow [instructions here](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork) to periodically synchronize your fork with the most recent version of this ("upstream") repository. This will ensure you use an up-to-date version of the model.
-
-### Setting up your development environment
-1. **Java Development Kit (JDK):** Ensure you have a JDK (Java Development Kit) installed on your system. You can download and install the latest version of OpenJDK from [Adoptium](https://adoptium.net/).
-2. **Download an IDE** (integrated development environment) of your choice - we recommend [IntelliJ IDEA](https://www.jetbrains.com/idea/download/); download the Community (free) or Ultimate (paid) edition, depending on your needs.
-3. Clone your forked repository to your local machine. Import the cloned repository into IntelliJ as a Maven project 
-
-### Compiling and running SimPaths with Maven in the CLI
-
-SimPaths can also be compiled by Maven ([installation instructions here](https://maven.apache.org/install.html)) and run from the command line without an IDE. After cloning the repository and setting up the JDK, in the root directory you can run:
-```
-$ mvn clean package
-```
-... to create two runnable jars for single- and multi-run SimPaths:
-```
-.
-SimPaths/
-      ...
-      |-- multirun.jar
-      |-- singlerun.jar
-      `-- src
-```
-
-To run the SimPathsStart setup phases and set up a population for subsequent multiruns, `singlerun.jar` takes the following options:
-
-- `-c` Country ['UK' or 'IT']
-- `-s` Start year
-- `-g` [true/false] show/hide gui
-- `--rewrite-policy-schedule` Re-write policy schedule from detected policy files
-- `-Setup` do setup phases (creating input populations database) only
-
-e.g.
-```
-$ java -jar singlerun.jar -c UK -s 2017 -g false -Setup
-```
-For multiple runs, `multirun.jar` takes the following options:
-
-- `-r` random seed for first run (incremented by +1 for subsequent runs)
-- `-p` simulated population size
-- `-n` number of runs
-- `-s` start year of runs
-- `-e` end year of runs
-- `-g` [true/false] show/hide gui
-- `-f` write console output and logs to file (in 'output/logs/run_[seed].txt')
-
-e.g.
-```
-$ java -jar multirun.jar -r 100 -p 50000 -n 20 -s 2017 -e 2020 -g false -f
-```
-
-Run `java -jar singlerun.jar -h` or `java -jar multirun.jar -h` to show these help messages.
-
-### Contributing
-
-1. Create a new branch for your contributions. This will likely be based on either the `main` branch of this repository (if you seek to modify the stable version of the model) or `develop` (if you seek to modify the most recent version of the model).  Please see branch naming convention below.
-2. Make your changes, add your code, and write tests if applicable.
-3. Commit your changes.
-4. Push your changes to your fork.
-5. Open a Pull Request (PR) on this repository from your fork. Be sure to provide a detailed description of your changes in the PR.
-
-### Branch Naming Conventions
-
-In our open-source project, we follow a clear and consistent branch naming convention to streamline the development process and maintain a structured repository. These conventions help our team of contributors collaborate effectively. Here are the primary branch naming patterns:
-
-1. **Main Branches:**
-    - `main`: Represents the stable version of our model.
-    - `develop`: Used for ongoing development and integration of new features.
-
-2. **Feature Branches:**
-    - `feature/your-feature-name`: Create feature branches for developing new features.
-
-3. **Bug Fix Branches:**
-    - `bugfix/issue-number-description`: Use bug fix branches for specific issue resolutions. For example, `bugfix/123-fix-health-process-issue`.
-
-6. **Experimental or Miscellaneous Branches:**
-    - `experimental/your-description`: For experimental or miscellaneous work not tied to specific features or bug fixes. For instance, `experimental/new-architecture`.
-
-7. **Documentation Branches:**
-    - `docs/documentation-topic`: Prefix documentation branches with `docs` for updating or creating documentation. For example, `docs/update-readme`.
-
-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.
--->
\ No newline at end of file
+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.
\ No newline at end of file
diff --git a/documentation/wiki/developer-guide/internals/multirun-implementation.md b/documentation/wiki/developer-guide/internals/multirun-implementation.md
index ab2f03dfd..ee798acbd 100644
--- a/documentation/wiki/developer-guide/internals/multirun-implementation.md
+++ b/documentation/wiki/developer-guide/internals/multirun-implementation.md
@@ -3,3 +3,140 @@
 !!! warning "In progress"
     This page is under development. Contributions welcome —
     see the [Developer Guide](../index.md) for how to contribute.
+
+## Running the MultiRun in the command line
+
+### Prerequisites
+
+- Java 19
+- Maven 3.8+
+- Optional IDE: IntelliJ IDEA (import as a Maven project)
+
+### Build and run
+
+In the command line, navigate to the project directory and run the following commands:
+
+```bash
+mvn clean package
+java -jar multirun.jar -DBSetup
+java -jar multirun.jar
+```
+
+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`.
+
+To use a different config file:
+
+```bash
+java -jar multirun.jar -config my_run.yml
+```
+
+For configuration options, see the annotated `config/default.yml`. For the data pipeline and further reference, see [`documentation/`](documentation/README.md).
+
+<!-- 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. -->
+
+
+<!--
+## Getting Started
+
+To contribute to this project, you need to fork the repository and set up your development environment.
+
+### Access to Data
+
+We are committed to maintaining transparency and open-source principles in this project. All the code, documentation, and resources related to our project are available on GitHub for you to explore, use, and contribute to.
+
+The data used by this project is not freely shareable. If you are interested in accessing the data necessary to run the simulation, get in touch with the repository maintainers for further instructions.
+
+However, please note that _training_ data is provided. It allows the simulation to be run and developed, but results obtained on the basis of the training dataset should not be interpreted, except for the purpose of training and development. 
+
+**How to Request Access to Data:**
+
+If you have a need for the data, please contact the repository maintainers through the [issue tracker](https://github.com/centreformicrosimulation/SimPaths/issues).
+
+
+### Forking the Repository
+
+1. Click the "Fork" button at the top-right corner of this repository.
+2. Untick the `Copy only the main branch` box.
+3. This will create a copy of the repository in your own GitHub account.
+4. Follow [instructions here](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork) to periodically synchronize your fork with the most recent version of this ("upstream") repository. This will ensure you use an up-to-date version of the model.
+
+### Setting up your development environment
+1. **Java Development Kit (JDK):** Ensure you have a JDK (Java Development Kit) installed on your system. You can download and install the latest version of OpenJDK from [Adoptium](https://adoptium.net/).
+2. **Download an IDE** (integrated development environment) of your choice - we recommend [IntelliJ IDEA](https://www.jetbrains.com/idea/download/); download the Community (free) or Ultimate (paid) edition, depending on your needs.
+3. Clone your forked repository to your local machine. Import the cloned repository into IntelliJ as a Maven project 
+
+### Compiling and running SimPaths with Maven in the CLI
+
+SimPaths can also be compiled by Maven ([installation instructions here](https://maven.apache.org/install.html)) and run from the command line without an IDE. After cloning the repository and setting up the JDK, in the root directory you can run:
+```
+$ mvn clean package
+```
+... to create two runnable jars for single- and multi-run SimPaths:
+```
+.
+SimPaths/
+      ...
+      |-- multirun.jar
+      |-- singlerun.jar
+      `-- src
+```
+
+To run the SimPathsStart setup phases and set up a population for subsequent multiruns, `singlerun.jar` takes the following options:
+
+- `-c` Country ['UK' or 'IT']
+- `-s` Start year
+- `-g` [true/false] show/hide gui
+- `--rewrite-policy-schedule` Re-write policy schedule from detected policy files
+- `-Setup` do setup phases (creating input populations database) only
+
+e.g.
+```
+$ java -jar singlerun.jar -c UK -s 2017 -g false -Setup
+```
+For multiple runs, `multirun.jar` takes the following options:
+
+- `-r` random seed for first run (incremented by +1 for subsequent runs)
+- `-p` simulated population size
+- `-n` number of runs
+- `-s` start year of runs
+- `-e` end year of runs
+- `-g` [true/false] show/hide gui
+- `-f` write console output and logs to file (in 'output/logs/run_[seed].txt')
+
+e.g.
+```
+$ java -jar multirun.jar -r 100 -p 50000 -n 20 -s 2017 -e 2020 -g false -f
+```
+
+Run `java -jar singlerun.jar -h` or `java -jar multirun.jar -h` to show these help messages.
+
+### Contributing
+
+1. Create a new branch for your contributions. This will likely be based on either the `main` branch of this repository (if you seek to modify the stable version of the model) or `develop` (if you seek to modify the most recent version of the model).  Please see branch naming convention below.
+2. Make your changes, add your code, and write tests if applicable.
+3. Commit your changes.
+4. Push your changes to your fork.
+5. Open a Pull Request (PR) on this repository from your fork. Be sure to provide a detailed description of your changes in the PR.
+
+### Branch Naming Conventions
+
+In our open-source project, we follow a clear and consistent branch naming convention to streamline the development process and maintain a structured repository. These conventions help our team of contributors collaborate effectively. Here are the primary branch naming patterns:
+
+1. **Main Branches:**
+    - `main`: Represents the stable version of our model.
+    - `develop`: Used for ongoing development and integration of new features.
+
+2. **Feature Branches:**
+    - `feature/your-feature-name`: Create feature branches for developing new features.
+
+3. **Bug Fix Branches:**
+    - `bugfix/issue-number-description`: Use bug fix branches for specific issue resolutions. For example, `bugfix/123-fix-health-process-issue`.
+
+6. **Experimental or Miscellaneous Branches:**
+    - `experimental/your-description`: For experimental or miscellaneous work not tied to specific features or bug fixes. For instance, `experimental/new-architecture`.
+
+7. **Documentation Branches:**
+    - `docs/documentation-topic`: Prefix documentation branches with `docs` for updating or creating documentation. For example, `docs/update-readme`.
+
+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.
+-->
\ No newline at end of file