open-standards/aac/aac-rs/tools/pagesets/data/fixed-paths.yaml
2026-10-15 13:15:15 -04:00

218 lines
9.5 KiB
YAML

# Fixed Paths — the design source of the motor-plan vocabulary.
#
# Rules (DESIGN-motor.md explains each):
# - Every location means one thing: it says one word, or it opens one page.
# No picture ever stands for different words depending on what was pressed
# before (no multi-meaning icon sequences: see the patent note in the
# design). Every button shows the word it says or the page it opens.
# - Every word has exactly one path at each size, of 1, 2 or 3 hits:
# home -> word; home -> page -> word; home -> page -> group -> word.
# - On a page, the place of the key that opened it closes it (Back, to the
# board the key is on): pressing the same place again is always the way back.
# - The set is made to be used with the app's "go back to Home after each
# word" (SPEC §5.6 item 6). That is the person's choice, so the set never
# turns it on: when it is added, the person is asked.
#
# What is decided here: the words, the page each belongs to when it is not on
# Home, and the group it falls into when its page is full. What is computed
# (solve.py, written to fixed-paths.layout.yaml): which words are on Home at
# each size (the heaviest), and where everything sits (frequency x motor cost).
#
# Licence: CC BY-SA 4.0.
set: fixed-paths
title: Fixed Paths
version: "0.1.0"
sizes: {"30": 5x6, "60": 6x10, "84": 7x12}
# Home at 30 locations is for a person starting out: the words that carry a
# message on their own, from Universal Core and Banajee et al. 2003 (asking,
# refusing, commenting, pointing), not the most frequent function words
# ("the", "a", "to" are one page away). 60 and 84 keep these 18 where they are
# and add the heaviest words by weight. (Decision of 2026-10-05.)
beginner_home: [I, you, it, that, what, want, more, go, help, stop, "not", like, all done, "yes", "no", my, look, do]
# Weight of a word = its spoken frequency (FrequencyWords 2018 subtitles,
# relative count) x (1 + aac_boost if it is in Universal Core or in Banajee et
# al. 2003's toddler core). A phrase weighs phrase_share x its proxy word.
# DESIGN-motor.md shows the metrics with aac_boost 0 as well.
aac_boost: 3
phrase_share: 0.25
# How hard a location is to reach, per size: a blend of three cost models,
# each scaled 0..1 over the grid (DESIGN-motor.md, "What easy means").
blend:
"30": {touch: 0.25, scan: 0.25, gaze: 0.5}
"60": {touch: 0.5, scan: 0.25, gaze: 0.25}
"84": {touch: 0.5, scan: 0.25, gaze: 0.25}
pages:
Social:
role: social
# A word in a group stays on the page while the page has room for it (the
# heaviest first); only when the page is full do the lightest go behind
# their group's key.
groups:
Answers: ["yes", "no", okay, maybe, yeah]
Manners: [please, thank you, sorry, excuse me, "you're welcome"]
Greetings: [hi, bye, how are you, see you later, good morning, good night]
Turn taking: [my turn, your turn, let me try, let me think]
Likes: [I like it, "I don't like it", I feel good, "I don't feel good", I love you]
Pauses: [never mind, slow down, I need a break, I need help]
Exclamations: [wow, uh oh, yay, ouch, oh, hey, well]
# Repairs keep their place on the page itself, however full it is: a
# conversation that has gone wrong is the worst time to look for a word.
always_direct: [wait, "I'm not finished", "that's not what I meant", say it again, "I don't know"]
words: [wait, "I'm not finished", "that's not what I meant", say it again, "I don't know"]
People:
role: people
groups:
Pronouns: [I, you, he, she, it, we, they, me, him, us, them, mine]
Owners: [my, your, his, her, our, their]
Family: [mom, dad, brother, sister, baby, grandma, grandpa, aunt, uncle, cousin]
Helpers: [teacher, doctor, nurse, therapist, dentist, police, neighbor]
Others: [friend, everyone, someone, nobody, people, man]
words: [this, that]
Actions:
role: action
groups:
Wanting: [want, need, like, love, hate, hope, wish]
Doing: [make, do, put, get, give, take, open, close, turn, cut, fix, build, touch, hug, play, help, stop]
Trying: [try, use, work, find, start, finish, keep, change, share, smell, win, lose]
Moving: [go, come, leave, stay, walk, run, climb, ride, swim, dance, jump, sit, stand, move, carry, push,
pull, throw, catch, hold, bring, drive]
Thinking: [think, know, remember, forget, understand, learn, teach, believe, worry, decide, choose, explain]
Talking: [say, tell, ask, call, talk, sing, read, write, draw, listen, hear, show, send, look, see, watch]
Daily: [wash, brush, sleep, wake up, clean, buy, pay, visit, count]
# can, will, would, could, have, let: on the page itself (or Home), never in a group.
words: [have, can, will, let, would, could]
Describe:
role: describe
groups:
Amount: [more, all done, some, all, different, same, very, really, just, too, also, almost, only, enough,
together]
Opinions: [good, bad, nice, funny, scary, beautiful, favorite, important, right, wrong, easy, difficult,
safe, dangerous, busy, ready]
Size and feel: [big, little, new, old, fast, slow, hot, cold, soft, hard, heavy, wet, dry, loud, quiet,
long, short, tall, full, empty, dirty]
Colors: [red, blue, green, yellow, orange, pink, purple, brown, black, white]
Numbers: [one, two, three, four, five, many, few, first, last, next]
words: []
Little words:
role: little
groups:
Questions: [what, where, who, when, why, how, how many]
Joining: [and, but, or, because, if, so, as, then]
Linking: [the, a, an, to, of, for, with, at, from, about, by, without]
Position: [in, "on", up, down, out, "off", back, over, under, behind, between, next to, around, through, away,
inside, outside, here, there]
Negatives: ["not", "don't", "didn't", "can't", "won't"]
words: []
Feelings:
role: describe
words: [feel, happy, sad, angry, scared, tired, sick, excited, bored, frustrated, confused, proud, lonely,
surprised, embarrassed, nervous, jealous, brave, comfortable, uncomfortable, dizzy, itchy, hungry,
thirsty]
Food:
role: thing
groups:
Flavors: [delicious, yucky, sweet, sour, salty, spicy, taste, cook]
words: [eat, drink, food, water, milk, juice, snack, breakfast, lunch, dinner, apple, banana, bread, cheese,
chicken, rice, cookie, fruit]
Places:
role: thing
words: [home, school, bathroom, bedroom, kitchen, park, store, playground, pool, beach, library, restaurant,
hospital, church, office, house, car]
Things:
role: thing
groups:
Play things: [toy, ball, book, game, music, song, story, movie, TV, phone, computer, picture, paper, pencil,
party]
Home things: [bed, chair, table, door, blanket, towel, soap, toothbrush, shower, money]
Clothes: [shirt, pants, shoes, jacket, hat]
Animals: [animal, pet, dog, cat, bird, fish]
Outside things: [tree, flower, weather, rain, sun, snow]
words: [thing, something, name]
Body:
role: thing
words: [head, hand, foot, stomach, eye, ear, mouth, nose, teeth, hurt, pain, medicine, allergy,
wheelchair]
Time:
role: describe
words: [now, later, today, tomorrow, yesterday, morning, afternoon, night, day, week, year, time, before,
after, until, again, always, never, sometimes, usually, often, already, still, birthday, holiday]
Word forms:
role: little
modifiers:
- {label: "+s", modifier: plural}
- {label: "+ed", modifier: past}
- {label: "+ing", modifier: present-progressive}
- {label: "will +", modifier: future}
- {label: "+'s", modifier: possessive}
- {label: "not +", modifier: negation}
- {label: "?", modifier: question}
words: [is, am, are, was, were, be, been, has, had, did, does, got, went, said]
# Symbols for page and group keys whose label is not itself a concept of the
# app's symbol index (written as `ext_aurasense_symbol`, which the app reads
# once Track B's chosen-symbol field has merged; the OBF image uses it now).
#
# A key may show the picture of one of the words behind it (an exemplar, as
# folders do everywhere); no two keys share a picture, and a key's label is
# never a word on the page it sits on.
key_symbols:
People: people
Actions: actions
Describe: big
Little words: in
Places: places
Things: toy
Body: head
Word forms: change
Social: hi
Greetings: bye
Turn taking: together
Likes: love
Exclamations: wow
Answers: "yes"
Manners: please
Pauses: break
Family: mom
Helpers: helper
Moving: move
Thinking: think
Talking: say
Daily: wash
Colors: color
Numbers: number
Size and feel: soft
Position: under
Flavors: delicious
Clothes: shirt
Animals: animal
Outside things: tree
Wanting: want
Doing: make
Trying: try
Amount: all
Opinions: good
Questions: questions
Joining: also
Linking: with
Negatives: not
Play things: ball
Home things: bed
Pronouns: you
Owners: my
Others: friend
# Vocabulary filters: show only these words, in their places (everything else
# is hidden in place, SPEC §3 item 3 and §3.1 item 3). "Show everything for
# now" is the client's, and never moves a word.
filters:
starter:
about: >-
The union of Universal Core (Finished as "all done") and Banajee et al.
2003's toddler core: words useful in every activity, for a person starting
out. A page key shows while any word behind it is shown.
from: [universal_core, banajee_2003]