Skip to content

Commit 7ea7b5f

Browse files
pavly-gergespavly-gerges
authored
Merge pull request #7 from Electrostat-Lab/oet-notes
COMPANION: Add build for dot diagrams and enhance medical note pages
2 parents 14a40c4 + 40b9837 commit 7ea7b5f

8 files changed

Lines changed: 956 additions & 1 deletion

File tree

‎modules/COMPANION/assets/dot/medical_listening.dot‎

Lines changed: 304 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,304 @@
1+
digraph medical_listening {
2+
3+
graph [
4+
rankdir = TB
5+
fontname = "Helvetica"
6+
fontsize = 11
7+
splines = ortho
8+
nodesep = 0.55
9+
ranksep = 0.65
10+
bgcolor = "white"
11+
label = "Medical Listening — Structural Diagram"
12+
labelloc = t
13+
labeljust = c
14+
]
15+
16+
node [
17+
fontname = "Helvetica"
18+
fontsize = 10
19+
shape = box
20+
style = "filled,rounded"
21+
penwidth = 0.6
22+
margin = "0.18,0.10"
23+
]
24+
25+
edge [
26+
fontname = "Helvetica"
27+
fontsize = 9
28+
arrowsize = 0.6
29+
penwidth = 0.7
30+
color = "#888780"
31+
]
32+
33+
/* ── ROOT ─────────────────────────────────────────────── */
34+
35+
root [
36+
label = "Medical Listening"
37+
fillcolor = "#EEEDFE"
38+
color = "#534AB7"
39+
fontcolor = "#26215C"
40+
fontsize = 13
41+
style = "filled,rounded"
42+
penwidth = 1.2
43+
]
44+
45+
/* ── CRITERIA CONTAINER (cluster) ─────────────────────── */
46+
47+
subgraph cluster_criteria {
48+
label = "Listening Criteria"
49+
style = "filled,rounded"
50+
fillcolor = "#E1F5EE"
51+
color = "#0F6E56"
52+
fontcolor = "#04342C"
53+
fontname = "Helvetica-Bold"
54+
fontsize = 11
55+
penwidth = 1.0
56+
margin = 18
57+
58+
/* ── C1: Context Identification ────────────────────── */
59+
60+
c1 [
61+
label = "1. Context Identification\nGist · Context switch · Headings"
62+
fillcolor = "#EEEDFE"
63+
color = "#534AB7"
64+
fontcolor = "#26215C"
65+
]
66+
67+
subgraph cluster_context {
68+
label = "Context components"
69+
style = "filled,rounded"
70+
fillcolor = "#E6F1FB"
71+
color = "#185FA5"
72+
fontcolor = "#042C53"
73+
fontsize = 10
74+
penwidth = 0.6
75+
margin = 12
76+
77+
c1_spatial [
78+
label = "Spatial\nObject components"
79+
fillcolor = "#E6F1FB"
80+
color = "#185FA5"
81+
fontcolor = "#0C447C"
82+
]
83+
84+
c1_temporal [
85+
label = "Temporal\nTime components"
86+
fillcolor = "#FAEEDA"
87+
color = "#854F0B"
88+
fontcolor = "#412402"
89+
]
90+
91+
c1_relations [
92+
label = "Relations\nSpatial · Temporal · Both"
93+
fillcolor = "#FAECE7"
94+
color = "#993C1D"
95+
fontcolor = "#4A1B0C"
96+
]
97+
}
98+
99+
c1_spatial -> c1_relations [style=solid]
100+
c1_temporal -> c1_relations [style=solid]
101+
102+
/* ── C2: People & Voices ───────────────────────────── */
103+
104+
c2 [
105+
label = "2. People & Voices\nNames · Tone listening"
106+
fillcolor = "#F1EFE8"
107+
color = "#5F5E5A"
108+
fontcolor = "#2C2C2A"
109+
]
110+
111+
/* ── C3: Affirmative ───────────────────────────────── */
112+
113+
c3 [
114+
label = "3. Affirmative Listening\nEnd of debate · Opinion · Argument"
115+
fillcolor = "#EEEDFE"
116+
color = "#534AB7"
117+
fontcolor = "#26215C"
118+
]
119+
120+
subgraph cluster_affirm {
121+
label = "Affirm types"
122+
style = "filled,rounded"
123+
fillcolor = "#f8f8f5"
124+
color = "#B4B2A9"
125+
fontsize = 10
126+
penwidth = 0.5
127+
margin = 10
128+
129+
c3_pos [
130+
label = "Positive\nagrees / yes"
131+
fillcolor = "#E1F5EE"
132+
color = "#0F6E56"
133+
fontcolor = "#04342C"
134+
]
135+
136+
c3_neg [
137+
label = "Negative\ndoubts / no"
138+
fillcolor = "#FAECE7"
139+
color = "#993C1D"
140+
fontcolor = "#4A1B0C"
141+
]
142+
143+
c3_par [
144+
label = "Paradoxical\nnegative form → yes"
145+
fillcolor = "#FAEEDA"
146+
color = "#854F0B"
147+
fontcolor = "#412402"
148+
]
149+
}
150+
151+
/* ── C4: Personal Opinions ─────────────────────────── */
152+
153+
c4 [
154+
label = "4. Personal Opinions\nAttribute to speaker"
155+
fillcolor = "#F1EFE8"
156+
color = "#5F5E5A"
157+
fontcolor = "#2C2C2A"
158+
]
159+
160+
/* ── C5: Object Details ────────────────────────────── */
161+
162+
c5 [
163+
label = "5. Object Details\nTrace object through extract"
164+
fillcolor = "#EEEDFE"
165+
color = "#534AB7"
166+
fontcolor = "#26215C"
167+
]
168+
169+
subgraph cluster_obj {
170+
label = "Object detail steps"
171+
style = "filled,rounded"
172+
fillcolor = "#E6F1FB"
173+
color = "#185FA5"
174+
fontcolor = "#042C53"
175+
fontsize = 10
176+
penwidth = 0.6
177+
margin = 12
178+
179+
c5_intro [
180+
label = "Intro statement\nBrief overview"
181+
fillcolor = "#E6F1FB"
182+
color = "#185FA5"
183+
fontcolor = "#0C447C"
184+
]
185+
186+
c5_comp [
187+
label = "Components\nParts / properties"
188+
fillcolor = "#E6F1FB"
189+
color = "#185FA5"
190+
fontcolor = "#0C447C"
191+
]
192+
193+
c5_rels [
194+
label = "Relations\nObject-to-object"
195+
fillcolor = "#E6F1FB"
196+
color = "#185FA5"
197+
fontcolor = "#0C447C"
198+
]
199+
}
200+
201+
c5_intro -> c5_comp [style=solid]
202+
c5_comp -> c5_rels [style=solid]
203+
204+
/* ── C6: Distractors ───────────────────────────────── */
205+
206+
c6 [
207+
label = "6. Distractors\nIdentify · Eliminate"
208+
fillcolor = "#FAECE7"
209+
color = "#993C1D"
210+
fontcolor = "#4A1B0C"
211+
]
212+
213+
/* ── C7: Memory Listening (encoding) ───────────────── */
214+
215+
c7 [
216+
label = "7. Memory Listening\nKeywords · Counterparts · Duplicates"
217+
fillcolor = "#EEEDFE"
218+
color = "#534AB7"
219+
fontcolor = "#26215C"
220+
]
221+
222+
/* ── C8: Memory Listening (summary) ────────────────── */
223+
224+
c8 [
225+
label = "8. Summary Memory\nPost-recording reconstruction"
226+
fillcolor = "#EEEDFE"
227+
color = "#534AB7"
228+
fontcolor = "#26215C"
229+
]
230+
231+
subgraph cluster_summary {
232+
label = "Summary modes"
233+
style = "filled,rounded"
234+
fillcolor = "#f8f8f5"
235+
color = "#B4B2A9"
236+
fontsize = 10
237+
penwidth = 0.5
238+
margin = 10
239+
240+
c8_end [
241+
label = "End-of-recording\nProf. notes / scientific models"
242+
fillcolor = "#E1F5EE"
243+
color = "#0F6E56"
244+
fontcolor = "#04342C"
245+
]
246+
247+
c8_rt [
248+
label = "Realtime\nScientific model diagram"
249+
fillcolor = "#FAEEDA"
250+
color = "#854F0B"
251+
fontcolor = "#412402"
252+
]
253+
}
254+
255+
} /* end cluster_criteria */
256+
257+
/* ── OUTPUT NODE ──────────────────────────────────────── */
258+
259+
output [
260+
label = "Structural Diagram\nObjects + interrelations (output)"
261+
fillcolor = "#FAECE7"
262+
color = "#993C1D"
263+
fontcolor = "#4A1B0C"
264+
penwidth = 1.0
265+
style = "filled,rounded"
266+
]
267+
268+
/* ── EDGES: root → criteria ───────────────────────────── */
269+
270+
root -> c1
271+
root -> c2
272+
root -> c3
273+
root -> c4
274+
root -> c5
275+
root -> c6
276+
root -> c7
277+
root -> c8
278+
279+
/* ── EDGES: criteria → sub-nodes ─────────────────────── */
280+
281+
c1 -> c1_spatial [lhead=cluster_context]
282+
c1 -> c1_temporal [lhead=cluster_context]
283+
284+
c3 -> c3_pos
285+
c3 -> c3_neg
286+
c3 -> c3_par
287+
288+
c5 -> c5_intro [lhead=cluster_obj]
289+
290+
c8 -> c8_end
291+
c8 -> c8_rt
292+
293+
/* ── EDGES: summary modes → output ───────────────────── */
294+
295+
c8_end -> output
296+
c8_rt -> output
297+
298+
/* ── RANK HINTS ───────────────────────────────────────── */
299+
300+
{ rank = same; c1; c2; c3; c4 }
301+
{ rank = same; c5; c6; c7; c8 }
302+
{ rank = same; c8_end; c8_rt }
303+
304+
}

‎modules/COMPANION/assets/dot/medical_writing.dot‎

Lines changed: 81 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,81 @@
1+
digraph OET_Writing_Strategy {
2+
graph [
3+
rankdir=TB
4+
fontname="Helvetica"
5+
fontsize=13
6+
bgcolor="transparent"
7+
pad=0.5
8+
nodesep=0.3
9+
ranksep=0.25
10+
label="OET Medical Writing — Step-wise Strategy"
11+
labelloc=t
12+
labeljust=c
13+
splines=false
14+
]
15+
node [
16+
fontname="Helvetica"
17+
shape=box
18+
style="rounded,filled"
19+
penwidth=0.8
20+
width=5.5
21+
margin="0.25,0.18"
22+
]
23+
edge [
24+
fontname="Helvetica"
25+
fontsize=10
26+
arrowhead=vee
27+
arrowsize=0.7
28+
penwidth=0.8
29+
color="#9C9A92"
30+
]
31+
32+
// ── STEP 1 — Teal ────────────────────────────────────────────────────
33+
S1 [
34+
label="[1] Establish purpose\nOpening brief + expanded closing reason"
35+
fillcolor="#085041"
36+
color="#5DCAA5"
37+
fontcolor="#9FE1CB"
38+
fontsize=12
39+
]
40+
41+
// ── STEP 2 — Purple ──────────────────────────────────────────────────
42+
S2 [
43+
label="[2] Select relevant content\nInclusion / exclusion based on context\nWriter–reader and patient–reader relationships"
44+
fillcolor="#3C3489"
45+
color="#AFA9EC"
46+
fontcolor="#CECBF6"
47+
fontsize=12
48+
]
49+
50+
// ── STEP 3 — Blue ────────────────────────────────────────────────────
51+
S3 [
52+
label="[3] Group and order information\nChronological — same situation, temporal sequence\nThematical — cross-situations, by reader importance\nMixed blend where relevant; note spatial relations"
53+
fillcolor="#0C447C"
54+
color="#85B7EB"
55+
fontcolor="#B5D4F4"
56+
fontsize=12
57+
]
58+
59+
// ── STEP 4 — Coral ───────────────────────────────────────────────────
60+
S4 [
61+
label="[4] Apply formal briefs and tense\nOpening brief — purpose + patient + referral intent\nDebrief — closing gratitude or invitation to contact\nTense follows temporal relationship of each fact"
62+
fillcolor="#712B13"
63+
color="#F0997B"
64+
fontcolor="#F5C4B3"
65+
fontsize=12
66+
]
67+
68+
// ── STEP 5 — Amber ───────────────────────────────────────────────────
69+
S5 [
70+
label="[5] Maintain formal register\nNo contractions\nNo excessive abbreviations\nNo informal / academic connectors\nFactual, non-judgemental; concise sentences"
71+
fillcolor="#633806"
72+
color="#EF9F27"
73+
fontcolor="#FAC775"
74+
fontsize=12
75+
]
76+
77+
S1 -> S2
78+
S2 -> S3
79+
S3 -> S4
80+
S4 -> S5
81+
}

0 commit comments

Comments
 (0)