Skip to content

Commit 1f6f63a

Browse files
committed
docs(demonstration): expand demo docs and standardize persona portrait assets
- add an Input files section to the demonstration README - remove visual separator lines and improve README structure - rewrite persona style and physical description files for clearer, reproducible guidance - rename base portrait images to a consistent anchor portrait naming scheme - add the Inge de Boer anchor portrait and remove obsolete office-setting images
1 parent d6e29f2 commit 1f6f63a

8 files changed

Lines changed: 234 additions & 84 deletions

resources/demonstration/README.md

Lines changed: 17 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -21,8 +21,6 @@ python infer_rules.py
2121
python run_query.py --input ..\queries\q1.rq
2222
```
2323

24-
______________________________________________________________________
25-
2624
## Folder structure
2725

2826
The demo is organized as follows:
@@ -49,7 +47,23 @@ Recommended interpretation:
4947
- `queries/` contains SPARQL query files
5048
- `scripts/` contains the pipeline scripts
5149

52-
______________________________________________________________________
50+
## Input files
51+
52+
The `inputs/` folder contains both source input files and intermediate Turtle files used by later steps in the pipeline.
53+
54+
### Source input files
55+
56+
- `prefix.csv` — Prefix registry used to expand CURIEs into full IRIs consistently across the demo inputs.
57+
- `input-standard.csv` — Vertical input file containing standard representation concepts and their semantic mappings.
58+
- `input-model.csv` — Vertical input file containing model representation concepts and their semantic mappings.
59+
- `input-horizontal.csv` — Horizontal input file containing asserted alignments between standard and model representation concepts.
60+
- `demo-schema.ttl` — Demo schema defining the core classes and relations used in the demonstration.
61+
- `health-ri-ontology.ttl` — Reference ontology providing ontology concepts and hierarchy for reasoning and querying.
62+
63+
### Generated intermediate files
64+
65+
- `instances.ttl` — Asserted instance graph generated by `create_instances.py`.
66+
- `instances_extended.ttl` — Enriched instance graph generated by `infer_rules.py` and used as the default graph for querying.
5367

5468
## Recommended order
5569

@@ -65,8 +79,6 @@ Run `infer_rules.py` to generate an extended graph, usually `instances_extended.
6579

6680
Run `run_query.py` with a SPARQL query file to export query results to CSV.
6781

68-
______________________________________________________________________
69-
7082
## 1) `create_instances.py`
7183

7284
### What it does
@@ -183,8 +195,6 @@ python create_instances.py ^
183195
--output ..\inputs\instances.ttl
184196
```
185197

186-
______________________________________________________________________
187-
188198
## 2) `infer_rules.py`
189199

190200
### What it does
@@ -290,8 +300,6 @@ python infer_rules.py ^
290300
--ontology-input ontologies\b.ttl
291301
```
292302

293-
______________________________________________________________________
294-
295303
## 3) `run_query.py`
296304

297305
### What it does
@@ -358,8 +366,6 @@ python run_query.py ^
358366
--output ..\outputs\scenario1-output.csv
359367
```
360368

361-
______________________________________________________________________
362-
363369
## Minimal end-to-end example
364370

365371
From `demonstration\scripts`:
@@ -376,8 +382,6 @@ Typical outputs:
376382
- `..\inputs\instances_extended.ttl`
377383
- `..\outputs\q1-output.csv`
378384

379-
______________________________________________________________________
380-
381385
## Dependency chain
382386

383387
```mermaid
@@ -405,8 +409,6 @@ flowchart TD
405409
I --> J
406410
```
407411

408-
______________________________________________________________________
409-
410412
## Short summary
411413

412414
- Use **`create_instances.py`** to generate the initial asserted RDF graph from CSV.

resources/demonstration/definitions/personas/base images/Dr. Amir Hassan in three perspectives.png renamed to resources/demonstration/definitions/personas/base images/Anchor portrait - Dr. Amir Hassan.png

File renamed without changes.

resources/demonstration/definitions/personas/base images/Professional portrait of Dr. van Dijk.png renamed to resources/demonstration/definitions/personas/base images/Anchor portrait - Dr. van Dijk.png

File renamed without changes.
1.96 MB
Loading
Binary file not shown.
Binary file not shown.

resources/demonstration/definitions/personas/description - drawing style.md

Lines changed: 70 additions & 53 deletions
Large diffs are not rendered by default.
Lines changed: 147 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,156 @@
1-
PHYSICAL DESCRIPTIONS
1+
# Physical Descriptions
22

3-
## Full version
3+
## Dr. Marieke van Dijk
44

5-
### Dr. Marieke van Dijk
5+
### Person description
66

7-
A woman in her early 40s with a professional and approachable presence. She has fair skin, light brown shoulder-length hair worn neatly with a slight wave, and gray-blue eyes. She has an oval face, a calm expression, and a subtle, confident smile. Medium height, slim-to-average build, upright posture. She wears understated professional clothing, such as a navy blazer over a light blouse, small stud earrings, and minimal makeup. Her overall appearance is polished, intelligent, and composed.
7+
A realistic adult woman, approximately late 30s to early 40s, with a polished, approachable professional appearance.
88

9-
### Dr. Amir Hassan
9+
### Physical appearance
1010

11-
A man in his late 30s to early 40s with a thoughtful, academic appearance. He has medium olive skin, short dark brown hair, and dark brown eyes. He has a neatly trimmed beard, a focused but warm expression, and a relaxed professional posture. Average-to-tall height, average build. He wears smart business-casual clothing, such as a dark blazer or fine-knit sweater over a collared shirt. His appearance suggests someone analytical, credible, and comfortable working across research and data-intensive environments.
11+
She has fair skin with a soft neutral-to-peach undertone and a smooth, even complexion. Her face is oval with a slight heart-shaped tendency: softly broad forehead, gently defined cheekbones, slim jawline, and a small, tapered chin. Her overall facial proportions are balanced and symmetrical, with delicate rather than dramatic features.
1212

13-
### Inge de Boer
13+
Her eyes are light blue-gray, slightly cool in tone, medium-sized, and almond-shaped, with a calm, attentive expression. Her eyebrows are light-to-medium brown, neat, natural-looking, and softly arched, with moderate thickness. Her nose is straight, slim, and refined, with a narrow bridge and a softly rounded tip. Her lips are medium in width, softly defined, naturally pink, and usually held in a subtle closed-mouth smile; the lower lip is slightly fuller than the upper lip.
1414

15-
Woman in her late 40s, clearly older-looking than Dr. Marieke van Dijk. Fair skin with a slightly cooler undertone, ash-dark-blonde hair in a short, straight, structured bob cut ending at the jawline, with a side part and very little wave. Light blue-green eyes, rectangular dark-framed glasses that should always be present, broader and slightly squarer face shape, stronger jawline, straighter nose, thinner lips, and a more practical, grounded expression rather than a polished consultant-like look. Medium height, average build, upright but less posed posture. She wears practical professional clothing in muted, cool tones, such as a charcoal or gray-blue cardigan or blazer over a pale blouse, with minimal jewelry. Overall appearance: experienced, organized, calm, trustworthy, operational, and clearly distinct from Marieke.
15+
Her hair is one of the strongest identity markers: a smooth, chin-to-just-above-shoulder-length bob in a warm light brown / chestnut-dark blonde range, with soft caramel highlights. It is side-parted, with the front section sweeping gently across the forehead. The hair has light layering and natural volume, tucked behind the ears in some views, and the ends curve softly outward around the jawline and neck. The finish is sleek and neat, not stiff, not curly, and not heavily textured.
1616

17-
#### Distinction constraints
17+
She wears small round stud earrings in a silver or white-metal setting, each with a tiny pale blue or clear stone. No necklace, no visible facial piercings beyond the ears, and no visible tattoos.
1818

19-
- Must look older than Marieke
20-
- Must have a shorter, straighter, more structured haircut than Marieke
21-
- Must always wear rectangular dark-framed glasses
22-
- Must have a broader, squarer face shape than Marieke
23-
- Must look more practical and operational, less polished and elegant than Marieke
24-
- Must use cooler tones and less refined styling than Marieke
25-
- Must not resemble Marieke in face shape, hairstyle, or overall visual impression
19+
Her makeup is minimal and professional: light natural foundation, subtle blush, understated neutral eye makeup, softly defined lashes, and a natural pink-nude lip. The look is clean, understated, and realistic.
20+
21+
### Clothing and style
22+
23+
She is dressed in classic business-professional clothing:
24+
25+
- Dark navy tailored blazer.
26+
- White blouse with a soft split V-notch neckline.
27+
- Minimalist accessories.
28+
- Conservative, elegant, office-appropriate styling.
29+
30+
Her overall style reads as competent, trustworthy, refined, and approachable: European corporate portrait styling, understated rather than fashionable, with a clean executive look.
31+
32+
### Key identity anchors to preserve
33+
34+
Preserve these features carefully:
35+
36+
- Fair skin with a soft peach-neutral undertone.
37+
- Oval / slightly heart-shaped face.
38+
- Light blue-gray almond-shaped eyes.
39+
- Neat soft-arched light-brown eyebrows.
40+
- Straight narrow nose.
41+
- Medium natural pink lips with a gentle closed-mouth smile.
42+
- Warm chestnut/light-brown bob with subtle caramel highlights.
43+
- Side-parted smooth bob, chin to just above shoulder length, softly layered, slightly flipped ends.
44+
- Small silver stud earrings.
45+
- Navy blazer over a white blouse.
46+
47+
### Image-specific presentation
48+
49+
The same woman is shown in three coordinated bust portraits:
50+
51+
1. front-facing view
52+
2. left-facing side profile
53+
3. slightly angled front / three-quarter view with a gentle head tilt
54+
55+
The background is a bright, softly blurred office interior with pale gray and off-white tones. Lighting is soft, diffuse, and flattering, with no harsh shadows. The portrait treatment is realistic but slightly stylized, with soft feathered edges near the lower part of the figures, giving the image a lightly painted or composited editorial-portrait feel.
56+
57+
### Useful negative constraints
58+
59+
Do not make her younger-looking, glamorous, heavily made up, sharply contoured, or fashion-forward. Do not change the hairstyle into long hair, curls, bangs, or a severe blunt cut. Do not change the eye color to brown or dark blue. Do not add bold jewelry, glasses, or bright clothing. Keep the expression warm, subtle, and professional.
60+
61+
## Dr. Amir Hassan
62+
63+
### Person description
64+
65+
A polished, approachable fictional man in his early-to-mid 30s, with a neat, professional appearance and a calm, confident demeanor.
66+
67+
### Physical appearance
68+
69+
He has a light-to-medium olive skin tone with a warm undertone. His face is oval with a gently tapered jaw, a defined chin, and soft but noticeable cheekbones. His forehead is of medium height and partially covered by the hairline and front texture.
70+
71+
His hair is dark brown to near-black, short, thick, and slightly wavy, with natural volume and lift on top and shorter, neatly trimmed sides. The hairline is even, with only slight recession at the temples. His eyebrows are dark, medium-thick, tidy, and gently arched. His eyes are medium-sized, almond-shaped, and warm brown to dark hazel, with a calm, attentive expression.
72+
73+
His nose is straight and medium-narrow, with a refined bridge and a softly rounded tip. His lips are medium in fullness, well-defined, and usually set in a subtle closed-mouth smile. Facial hair consists of a short, neatly groomed boxed beard and mustache, evenly trimmed, dark brown to black, and slightly fuller along the jawline and chin, with clean cheek lines.
74+
75+
His ears are medium-sized, fairly close to the head, and fully visible. His neck is of average length and proportionate. His build appears slim-to-average from the visible upper torso.
76+
77+
### Expression and overall impression
78+
79+
He appears friendly, composed, and self-assured. His expression is understated and professional rather than dramatic, with a slight smile, relaxed eyes, and calm posture. His overall presence is polished, credible, and approachable.
80+
81+
### Clothing and style
82+
83+
He is dressed in classic business-professional clothing:
84+
85+
- Dark navy blazer with a structured but modern fit.
86+
- Light blue dress shirt with a soft collar, worn open at the neck without a tie.
87+
- No visible jewelry, glasses, or other accessories.
88+
- Meticulous, understated grooming.
89+
90+
His overall style is classic business-professional: clean, modern, refined, and realistic.
91+
92+
### Typical presentation
93+
94+
He is presented with upright posture and relaxed shoulders. His chin is level or slightly raised, and his expression is friendly but restrained. He appears consistently well-groomed and polished.
95+
96+
### Key identity anchors to preserve
97+
98+
Preserve these features carefully:
99+
100+
- Short dark slightly wavy hair with moderate volume on top.
101+
- Neatly trimmed short boxed beard and mustache.
102+
- Warm olive complexion and oval, gently tapered face shape.
103+
- Calm, slight smile and approachable professional demeanor.
104+
- Dark navy blazer and light blue open-collar dress shirt.
105+
- Neat, realistic, business-professional overall presentation.
106+
107+
### Useful negative constraints
108+
109+
Do not add a tie or glasses. Do not make him appear heavily wrinkled, significantly older, rugged, or overly stylized. Do not change the hairstyle into a buzz cut, long hair, or a clean-shaven look. Do not use casual clothing or flashy styling.
110+
111+
## Inge de Boer
112+
113+
### Person description
114+
115+
A realistic adult woman in her early-to-mid 40s, with a friendly, grounded, approachable presence that feels natural and unpretentious. She looks like a practical, capable professional rather than a polished executive.
116+
117+
### Physical appearance
118+
119+
She has light fair skin with a soft pink-to-neutral undertone and a healthy, natural complexion with slight real-life texture, giving her a believable, approachable appearance. Her face is moderately long and softly narrow, with a gently high forehead, leaner cheeks, a softly defined jawline, and a rounded chin. Her features are open, natural, and expressive rather than delicate, glamorous, symmetrical, or refined.
120+
121+
Her eyes are clear medium blue, lively but calm, with a warm, attentive expression that suggests friendliness and patience. They are medium-sized, slightly rounded, and set in a way that feels direct and approachable. Her eyebrows are light-to-medium blonde or dark blonde, natural in shape, softly defined, and not heavily styled or sharply sculpted. Her nose is medium in size, fairly straight, and gently narrow, with a natural, unforced structure that suits the face without looking dramatic or refined. Her lips are medium in fullness, with a softer outline and a naturally warm expression that can shift into a broader, genuine smile.
122+
123+
Her hair is dark blonde to light blonde, naturally straight to slightly loose-textured, usually worn pulled back in a practical low ponytail or loosely gathered style for work. A few soft strands may frame the face, and the overall look is tidy but relaxed, reflecting someone focused on work rather than appearance. It is not sleek, sharply cut, or salon-polished. No glamorous styling, no fashion-forward finish, and no overly deliberate hair design.
124+
125+
She may wear very minimal jewelry, such as a fine necklace, tiny studs, or no visible jewelry at all. Glasses are optional, but should be subtle and understated if present. No glamorous styling, no visible tattoos, and no statement accessories.
126+
127+
Her makeup is minimal to nearly absent: perhaps light concealer, a natural lip tone, and very subtle definition around the eyes, but overall natural and realistic.
128+
129+
### Clothing and style
130+
131+
She is dressed in understated modern professional attire:
132+
133+
- muted gray, charcoal, soft navy, or subdued olive outer layer
134+
- light gray, dusty blue, soft teal, or off-white blouse, knit top, or simple layered shirt
135+
- practical, believable, office-appropriate or academic-professional styling
136+
- minimal accessories, possibly a thin necklace, simple watch, or nothing visible
137+
138+
Her overall style reads as warm, reliable, thoughtful, and approachable: someone who works carefully with documentation, coordination, stewardship, or governance, and whose appearance reflects trustworthiness and clarity rather than executive polish.
139+
140+
### Key identity anchors to preserve
141+
142+
Preserve these features carefully:
143+
144+
- light fair skin with a soft pink-neutral undertone
145+
- moderately long, softly narrow face with a gentle jawline
146+
- medium blue, friendly, attentive eyes
147+
- natural blonde to dark blonde brows with a soft shape
148+
- medium, fairly straight nose with natural proportions
149+
- medium lips with a genuine, warm smile
150+
- dark blonde to light blonde hair, usually pulled back in a low practical style
151+
- minimal makeup and understated accessories
152+
- muted, realistic professional clothing in gray, blue, olive, or off-white tones
153+
154+
### Useful negative constraints
155+
156+
Do not make her olive-skinned, dark-haired, glamorous, delicate-featured, or highly polished. Do not use deep brown eyes, a broad sturdy jawline, thick dark wavy hair, a structured low bun, or strongly executive styling. Do not make the expression overly reserved, severe, or portrait-formal; allow a more open, friendly smile. Do not make the styling editorial, luxurious, or portrait-perfect. Keep the result realistic, approachable, natural, and clearly suited to a practical professional role.

0 commit comments

Comments
 (0)