Skip to content

Commit 553a6d2

Browse files
author
hk-2029
committed
Restructure site navigation and add funding page
1 parent edeebd0 commit 553a6d2

7 files changed

Lines changed: 228 additions & 98 deletions

File tree

‎documentation/wiki/assets/css/extra.css‎

Lines changed: 61 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -654,6 +654,15 @@
654654
margin-bottom: 1.2rem;
655655
}
656656

657+
[data-md-color-scheme="slate"] .md-typeset .section-intro,
658+
.md-typeset .section-intro {
659+
max-width: 46rem;
660+
margin: -0.55rem 0 1rem;
661+
color: var(--md-default-fg-color--light);
662+
text-align: left;
663+
hyphens: none;
664+
}
665+
657666
[data-md-color-scheme="slate"] .md-typeset .section-heading {
658667
color: #c8d8e8;
659668
}
@@ -669,8 +678,18 @@
669678
margin: 1.2rem 0;
670679
}
671680

681+
.md-typeset .card-grid--primary {
682+
grid-template-columns: repeat(2, 1fr);
683+
margin-bottom: 0.85rem;
684+
}
685+
686+
.md-typeset .card-grid--secondary {
687+
margin-top: 0;
688+
}
689+
672690
.md-typeset a.feature-card {
673-
display: block;
691+
display: flex;
692+
flex-direction: column;
674693
background: var(--md-default-bg-color);
675694
border: 0.5px solid var(--sp-ghost);
676695
border-radius: 8px;
@@ -686,6 +705,11 @@
686705
cursor: pointer;
687706
}
688707

708+
.md-typeset a.feature-card.feature-card--primary {
709+
padding: 1.6rem 1.6rem 1.4rem;
710+
min-height: 13.2rem;
711+
}
712+
689713
/* Crimson top-border reveal on hover */
690714
.md-typeset a.feature-card::before {
691715
content: '';
@@ -730,11 +754,13 @@
730754

731755
/* Per-card icon colours — muted, scholarly tones */
732756
.card-icon--overview { background: rgba(42,56,72,0.08); color: #2A3848; }
757+
.card-icon--docs { background: rgba(42,86,72,0.08); color: #2a5648; }
733758
.card-icon--start { background: rgba(42,86,72,0.08); color: #2a5648; }
734759
.card-icon--user { background: rgba(72,52,92,0.08); color: #48345c; }
735760
.card-icon--dev { background: rgba(92,68,42,0.08); color: #5c442a; }
736761
.card-icon--ref { background: rgba(42,56,72,0.08); color: #2A3848; }
737762
.card-icon--research { background: rgba(117,0,3,0.07); color: var(--sp-crimson); }
763+
.card-icon--funding { background: rgba(122,95,32,0.08); color: #7a5f20; }
738764

739765
/* ── Card text ── */
740766
.md-typeset a.feature-card h3 {
@@ -747,6 +773,11 @@
747773
border: none !important;
748774
}
749775

776+
.md-typeset a.feature-card.feature-card--primary h3 {
777+
font-size: 1.1rem !important;
778+
margin-bottom: 0.35rem !important;
779+
}
780+
750781
.md-typeset a.feature-card p {
751782
font-size: 0.73rem;
752783
color: var(--md-default-fg-color--light);
@@ -755,6 +786,11 @@
755786
text-align: left;
756787
}
757788

789+
.md-typeset a.feature-card.feature-card--primary p {
790+
font-size: 0.78rem;
791+
line-height: 1.6;
792+
}
793+
758794
.md-typeset a.feature-card .card-link {
759795
font-size: 0.72rem;
760796
font-weight: 600;
@@ -763,6 +799,7 @@
763799
align-items: center;
764800
gap: 0.15rem;
765801
transition: gap 0.2s ease, color 0.15s ease;
802+
margin-top: auto;
766803
}
767804

768805
.md-typeset a.feature-card:hover .card-link {
@@ -786,19 +823,23 @@
786823
}
787824

788825
[data-md-color-scheme="slate"] .card-icon--overview { background: rgba(195,198,213,0.1); color: #a0b0c4; }
826+
[data-md-color-scheme="slate"] .card-icon--docs { background: rgba(16,163,100,0.12); color: #34d399; }
789827
[data-md-color-scheme="slate"] .card-icon--start { background: rgba(16,163,100,0.12); color: #34d399; }
790828
[data-md-color-scheme="slate"] .card-icon--user { background: rgba(139,92,214,0.12); color: #a78bfa; }
791829
[data-md-color-scheme="slate"] .card-icon--dev { background: rgba(220,120,30,0.12); color: #f0a050; }
792830
[data-md-color-scheme="slate"] .card-icon--ref { background: rgba(195,198,213,0.1); color: #a0b0c4; }
793831
[data-md-color-scheme="slate"] .card-icon--research { background: rgba(200,60,80,0.12); color: #f06080; }
832+
[data-md-color-scheme="slate"] .card-icon--funding { background: rgba(242,193,92,0.12); color: #f2c15c; }
794833

795834
/* ── Responsive ── */
796835
@media (max-width: 700px) {
836+
.md-typeset .card-grid--primary,
797837
.md-typeset .card-grid {
798838
grid-template-columns: repeat(2, 1fr);
799839
}
800840
}
801841
@media (max-width: 420px) {
842+
.md-typeset .card-grid--primary,
802843
.md-typeset .card-grid {
803844
grid-template-columns: 1fr;
804845
}
@@ -868,7 +909,8 @@
868909
visibility: visible;
869910
display: block;
870911
font-size: 0.6rem;
871-
letter-spacing: 0.1em;
912+
font-weight: 500;
913+
letter-spacing: 0.125em;
872914
text-transform: uppercase;
873915
line-height: 1.35;
874916
color: var(--sp-midnight) !important;
@@ -1089,6 +1131,14 @@
10891131
margin-bottom: 0;
10901132
}
10911133

1134+
.md-typeset .research-intro {
1135+
max-width: 46rem;
1136+
margin: 0 0 0.85rem;
1137+
color: var(--md-default-fg-color--light);
1138+
text-align: left;
1139+
hyphens: none;
1140+
}
1141+
10921142
.md-typeset .archive-link {
10931143
font-family: "Inter", var(--md-text-font) !important;
10941144
font-size: 0.6rem;
@@ -1192,6 +1242,15 @@
11921242
grid-column: 1;
11931243
}
11941244

1245+
.md-typeset .research-summary {
1246+
font-size: 0.75rem;
1247+
color: var(--md-default-fg-color--light);
1248+
margin: 0.35rem 0 0 !important;
1249+
text-align: left;
1250+
line-height: 1.55;
1251+
grid-column: 1;
1252+
}
1253+
11951254
/* ── Dark mode research ── */
11961255
[data-md-color-scheme="slate"] .md-typeset a.research-entry {
11971256
border-color: rgba(195,198,213,0.1);

‎documentation/wiki/documentation/index.md‎

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
# Documentation
2+
3+
SimPaths documentation is organised around three routes depending on what you need to do: get the model running, work with simulations in practice, or extend the codebase.
4+
5+
<div class="card-grid card-grid--docs">
6+
7+
<a href="../getting-started/" class="feature-card">
8+
<div class="card-icon-wrap card-icon--start">
9+
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><polygon points="5 3 19 12 5 21 5 3"/></svg>
10+
</div>
11+
<h3>Getting Started</h3>
12+
<p>Set up your environment, obtain the required input data, and run your first simulation.</p>
13+
<span class="card-link">Start here →</span>
14+
</a>
15+
16+
<a href="../user-guide/" class="feature-card">
17+
<div class="card-icon-wrap card-icon--user">
18+
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="3"/><path d="M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 0 1-2.83 2.83l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 0 1-4 0v-.09A1.65 1.65 0 0 0 9 19.4a1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 0 1-2.83-2.83l.06-.06A1.65 1.65 0 0 0 4.68 15a1.65 1.65 0 0 0-1.51-1H3a2 2 0 0 1 0-4h.09A1.65 1.65 0 0 0 4.6 9a1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 0 1 2.83-2.83l.06.06A1.65 1.65 0 0 0 9 4.68a1.65 1.65 0 0 0 1-1.51V3a2 2 0 0 1 4 0v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 0 1 2.83 2.83l-.06.06A1.65 1.65 0 0 0 19.4 9a1.65 1.65 0 0 0 1.51 1H21a2 2 0 0 1 0 4h-.09a1.65 1.65 0 0 0-1.51 1z"/></svg>
19+
</div>
20+
<h3>User Guide</h3>
21+
<p>Run single or multiple simulations, work with the GUI, and adjust tax-benefit settings or scenarios.</p>
22+
<span class="card-link">Use the model →</span>
23+
</a>
24+
25+
<a href="../developer-guide/" class="feature-card">
26+
<div class="card-icon-wrap card-icon--dev">
27+
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><polyline points="16 18 22 12 16 6"/><polyline points="8 6 2 12 8 18"/></svg>
28+
</div>
29+
<h3>Developer Guide</h3>
30+
<p>Navigate the architecture, internal APIs, JAS-mine integration, and extension workflows for SimPaths.</p>
31+
<span class="card-link">Develop →</span>
32+
</a>
33+
34+
</div>
35+
36+
## How to use this section
37+
38+
- Start with [Getting Started](../getting-started/index.md) if you are new to SimPaths.
39+
- Use the [User Guide](../user-guide/index.md) if you already have the model running and want to work with simulations.
40+
- Go to the [Developer Guide](../developer-guide/index.md) if you are changing code, architecture, or model internals.

‎documentation/wiki/funding/index.md‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# Funding
2+
3+
SimPaths has been supported by a range of past and present grants across partner institutions. The list below summarises grants that have supported the development of the model, its application in policy analysis, and associated research programmes.
4+
5+
Official award or project pages are linked where they have already been confirmed.
6+
7+
## Current Funding
8+
9+
- **2021-2026**: *Evaluation of the health impacts of Universal Credit: a mixed methods study* — **NIHR**
10+
- **2022-2027**: *Greater Essex Health Determinants Research Collaboration* — **NIHR**
11+
- **2023-2027**: *Sustainable Welfare: Rethinking the roles of Family, Market and State (SUSTAINWELL)* — **Horizon Europe**
12+
- **2024-2028**: *Policy Modelling for Health* — **UKRI PHI**
13+
- **2025-2028**: *WELLSIM: A life course microsimulation perspective on multi-dimensional well-being for five European countries* — **CHANSE/NORFACE**
14+
- **2025-2028**: *Evaluating the impact of major income support policies on health inequalities across the life course: a micro-macro linked modelling study (MicMac)* — **NIHR**. [Award page](https://fundingawards.nihr.ac.uk/award/NIHR168008)
15+
16+
## Past Funding
17+
18+
- **2019-2021**: *Investigating Economic Insecurity: A Microsimulation Approach* — **INAPP**
19+
- **2021-2022**: *Understanding the impacts of income and welfare policy responses to COVID-19 on inequalities in mental health: A microsimulation model* — **Health Foundation**
20+
- **2021-2024**: *Caring Over the Lifecycle: the Roles of Families and Welfare States Today and Into the Future* — **JPI**
21+
- **2021-2025**: *Health Equity of Economic Determinants (HEED): A Pan-European Microsimulation model for Health impacts of Income and Social Security Policies* — **ERC**
22+
- **2023-2025**: *Overlapping crises: (Re)shaping the future of regional labour markets (OVERLAP)* — **ESPON**

‎documentation/wiki/index.md‎

Lines changed: 39 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -21,60 +21,51 @@ SimPaths builds upon **JAS-mine**, an open-source Java platform designed for dis
2121
</div>
2222

2323
<div class="hero-cta">
24-
<a href="getting-started/" class="btn-primary">Get Started →</a>
25-
<a href="overview/" class="btn-secondary">Read the Docs</a>
24+
<a href="documentation/" class="btn-primary">Explore Documentation →</a>
25+
<a href="overview/" class="btn-secondary">Explore the Model</a>
2626
<a href="https://github.com/simpaths/SimPaths" class="btn-secondary">View on GitHub</a>
2727
</div>
2828

2929
</div>
3030

3131
---
3232

33-
<h2 class="section-heading">Explore the Documentation</h2>
33+
<h2 class="section-heading">Explore SimPaths</h2>
3434

35-
<div class="card-grid">
35+
<p class="section-intro">
36+
SimPaths now brings together model explanation, practical documentation, validation work,
37+
research outputs, and project-level information in one place.
38+
</p>
3639

37-
<a href="overview/" class="feature-card">
40+
<div class="card-grid card-grid--primary">
41+
42+
<a href="overview/" class="feature-card feature-card--primary">
3843
<div class="card-icon-wrap card-icon--overview">
3944
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><path d="M2 12h20"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/></svg>
4045
</div>
41-
<h3>Overview</h3>
42-
<p>What SimPaths models and why — architecture, modules, and parameterisation.</p>
43-
<span class="card-link">Explore →</span>
46+
<h3>Model</h3>
47+
<p>Understand what SimPaths models, how it is parameterised, which modules it includes, and how the framework extends across countries.</p>
48+
<span class="card-link">Explore the model →</span>
4449
</a>
4550

46-
<a href="getting-started/" class="feature-card">
47-
<div class="card-icon-wrap card-icon--start">
48-
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><polygon points="5 3 19 12 5 21 5 3"/></svg>
51+
<a href="documentation/" class="feature-card feature-card--primary">
52+
<div class="card-icon-wrap card-icon--docs">
53+
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M4 19.5A2.5 2.5 0 0 1 6.5 17H20"/><path d="M6.5 2H20v20H6.5A2.5 2.5 0 0 1 4 19.5v-15A2.5 2.5 0 0 1 6.5 2z"/></svg>
4954
</div>
50-
<h3>Getting Started</h3>
51-
<p>Set up your environment, load input data, and run your first simulation.</p>
52-
<span class="card-link">Get Started →</span>
55+
<h3>Documentation</h3>
56+
<p>Find the paths for getting started, running simulations in practice, and navigating the developer-facing internals of SimPaths.</p>
57+
<span class="card-link">Open documentation →</span>
5358
</a>
5459

55-
<a href="user-guide/" class="feature-card">
56-
<div class="card-icon-wrap card-icon--user">
57-
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="3"/><path d="M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 0 1-2.83 2.83l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 0 1-4 0v-.09A1.65 1.65 0 0 0 9 19.4a1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 0 1-2.83-2.83l.06-.06A1.65 1.65 0 0 0 4.68 15a1.65 1.65 0 0 0-1.51-1H3a2 2 0 0 1 0-4h.09A1.65 1.65 0 0 0 4.6 9a1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 0 1 2.83-2.83l.06.06A1.65 1.65 0 0 0 9 4.68a1.65 1.65 0 0 0 1-1.51V3a2 2 0 0 1 4 0v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 0 1 2.83 2.83l-.06.06A1.65 1.65 0 0 0 19.4 9a1.65 1.65 0 0 0 1.51 1H21a2 2 0 0 1 0 4h-.09a1.65 1.65 0 0 0-1.51 1z"/></svg>
5860
</div>
59-
<h3>User Guide</h3>
60-
<p>Single and multi-run simulations, GUI, parameter editing, and uncertainty analysis.</p>
61-
<span class="card-link">View Guide →</span>
62-
</a>
6361

64-
<a href="developer-guide/" class="feature-card">
65-
<div class="card-icon-wrap card-icon--dev">
66-
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><polyline points="16 18 22 12 16 6"/><polyline points="8 6 2 12 8 18"/></svg>
67-
</div>
68-
<h3>Developer Guide</h3>
69-
<p>JAS-mine architecture, SimPaths internals, and how-to guides for extending the model.</p>
70-
<span class="card-link">Developer Guide →</span>
71-
</a>
62+
<div class="card-grid card-grid--secondary">
7263

7364
<a href="validation/" class="feature-card">
7465
<div class="card-icon-wrap card-icon--ref">
7566
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M9 11l3 3L22 4"/><path d="M21 12v7a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h11"/></svg>
7667
</div>
77-
<h3>Model Validation</h3>
68+
<h3>Validation</h3>
7869
<p>Validation procedures, alignment diagnostics, and comparison against external targets.</p>
7970
<span class="card-link">Validation →</span>
8071
</a>
@@ -88,16 +79,30 @@ SimPaths builds upon **JAS-mine**, an open-source Java platform designed for dis
8879
<span class="card-link">Research →</span>
8980
</a>
9081

82+
<a href="funding/" class="feature-card">
83+
<div class="card-icon-wrap card-icon--funding">
84+
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M3 10h18"/><path d="M5 10v8"/><path d="M9 10v8"/><path d="M15 10v8"/><path d="M19 10v8"/><path d="M2 18h20"/><path d="M12 2l10 5H2l10-5z"/></svg>
85+
</div>
86+
<h3>Funding</h3>
87+
<p>See the grants and programmes that have supported the development and application of SimPaths.</p>
88+
<span class="card-link">Funding →</span>
89+
</a>
90+
9191
</div>
9292

9393
---
9494

9595
<div class="research-section">
9696
<div class="research-header">
97-
<h2 class="section-heading">Latest Research</h2>
97+
<h2 class="section-heading">Recent Research Highlights</h2>
9898
<a href="research/" class="archive-link">ALL PUBLICATIONS →</a>
9999
</div>
100100

101+
<p class="research-intro">
102+
Peer-reviewed research using SimPaths spans life-course dynamics, mental health inequalities,
103+
and the design of tax and welfare policy.
104+
</p>
105+
101106
<div class="research-list">
102107

103108
<a href="https://doi.org/10.1093/eurpub/ckaf161.076" class="research-entry">
@@ -107,6 +112,7 @@ SimPaths builds upon **JAS-mine**, an open-source Java platform designed for dis
107112
</div>
108113
<h3>Tax reforms vs benefit enhancement to address mental health inequalities: a microsimulation study</h3>
109114
<p class="research-authors">Igelstrom E, Kopasker D, Richiardi MG, Katikireddi SV</p>
115+
<p class="research-summary">Compares alternative fiscal policy responses and their implications for mental health inequalities.</p>
110116
<span class="research-arrow">→</span>
111117
</a>
112118

@@ -117,16 +123,7 @@ SimPaths builds upon **JAS-mine**, an open-source Java platform designed for dis
117123
</div>
118124
<h3>Attenuation and reinforcement mechanisms over the life course</h3>
119125
<p class="research-authors">Richiardi M, Bronka P, van de Ven J</p>
120-
<span class="research-arrow">→</span>
121-
</a>
122-
123-
<a href="https://doi.org/10.1016/j.socscimed.2024.116953" class="research-entry">
124-
<div class="research-entry__meta">
125-
<span class="research-label">POLICY ANALYSIS · 2024</span>
126-
<span class="research-journal">Social Science &amp; Medicine</span>
127-
</div>
128-
<h3>Evaluating the influence of taxation and social security policies on psychological distress</h3>
129-
<p class="research-authors">Kopasker D, Bronka P, Thomson RM, et al.</p>
126+
<p class="research-summary">Examines how early advantage and disadvantage can compound or soften across the life course.</p>
130127
<span class="research-arrow">→</span>
131128
</a>
132129

@@ -137,6 +134,7 @@ SimPaths builds upon **JAS-mine**, an open-source Java platform designed for dis
137134
</div>
138135
<h3>Short-term impacts of Universal Basic Income on population mental health inequalities in the UK</h3>
139136
<p class="research-authors">Thomson RM, Kopasker D, Bronka P, et al.</p>
137+
<p class="research-summary">Uses microsimulation to estimate how Universal Basic Income could affect mental health across the UK population.</p>
140138
<span class="research-arrow">→</span>
141139
</a>
142140

‎documentation/wiki/overview/index.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Overview
1+
# Model
22

33
SimPaths is a family of models for individual and household life course events, all sharing common components. The framework is designed to project life histories through time, building up a detailed picture of career paths, family (inter)relations, health, and financial circumstances. It builds upon standardised assumptions and data sources, which facilitates adaptation to alternative countries.
44

‎documentation/wiki/user-guide/index.md‎

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,11 @@
11
# User Guide
22

3-
The guide below describes how SimPaths can be used to run simulations from the GUI (Graphical User Interface) and create scenarios by changing the GUI parameters, the input data, or the tax-benefit parameters.
3+
The user guide explains how SimPaths can be used to run simulations from the GUI (Graphical User Interface), set up multiple runs, and create scenarios by changing GUI parameters, input data, or tax-benefit settings.
4+
5+
## Sections
6+
7+
- [Single Runs](single-runs.md) — run an individual simulation and inspect outputs
8+
- [Multiple Runs](multiple-runs.md) — manage repeated simulations and persistence choices
9+
- [Graphical User Interface](gui.md) — work through the main controls and displays
10+
- [Modifying Tax-Benefit Settings](tax-benefit-parameters.md) — adjust policy-related inputs
11+
- [Uncertainty Analysis](uncertainty-analysis.md) — explore stochastic variation and sensitivity

0 commit comments

Comments
 (0)