.. todo:: text descriptions! very many add blurb for discontiguous ipsi/contra selectable areas this can be copy/pasted to mention that each half can be selected separately add images of each "zoomed-in" and selected location as this would be seen in the navigation window .. _predefined_locations: ******************** Predefined Locations ******************** .. warning:: At the moment, this is a very rough list with the full set of information available in the Location/orientation spreadsheet, but none of it is explained or cleaned up to be understood by someone outside the team. It needs a lot of text descriptions filled in to make sense, and the intention is that every listed area will eventually have a matching image to show what it would look like as the selected area in the (zoomed-in) image view of the Location/Hand Part module. (**Introduction:** Give a quick overview of our predefined locations, link to sources we used in consideration while building this list, mention the specificity available from the suboptions. Especially comment on how the highlighted areas in each image are meant to be used as a reference, not a strict definition. The text labels are the only recorded information in each module, so they can be defined in a different way internally if the user wishes.) **(Will we still have a mechanism to add more user-defined locations? What might this look like?)** .. _body_location_list: 1. Body locations ````````````````` **(Add description: as applicable to Location module for two location types)** .. note: **Sub-areas and surfaces** Default set of surfaces: Anterior, Posterior, Lateral, Medial, Top, Bottom Default set of sub-areas: contra half, upper half, whole, centre, lower half, ipsi half (none of the locations with dedicated ipsi/contra sublocations allow the ipsi or contra sub-areas) .. _head_locations: Head ==== (no surfaces allowed on any head locations except tongue, mentioned below. assume all sub-areas are allowed unless mentioned otherwise.) .. _back_of_head: Head>Back of head ~~~~~~~~~~~~~~~~~ .. _top_of_head: Head>Top of head ~~~~~~~~~~~~~~~~ (not allowed to select upper or lower sub-area) .. _side_of_face: Head>Side of face ~~~~~~~~~~~~~~~~~ → ipsi/contra discontiguous sublocations .. _face_locations: Head>Face ~~~~~~~~~ **Head>Face>Temple** → ipsi/contra discontiguous sublocations **Head>Face>Above forehead (hairline)** **Head>Face>Forehead** **Head>Face>Eyebrow** → ipsi/contra discontiguous sublocations **Head>Face>Eyebrow>Between eyebrows** **Head>Face>Eye** → ipsi/contra discontiguous sublocations **Head>Face>Eye>Outer corner of eye** → ipsi/contra discontiguous sublocations (the ipsi/contra sublocations do not allow any sub-areas or surfaces) **Head>Face>Eye>Upper eyelid** → ipsi/contra discontiguous sublocations **Head>Face>Eye>Lower eyelid** → ipsi/contra discontiguous sublocations **Head>Face>Cheek/nose** **Head>Face>Cheek/nose>Cheek** → ipsi/contra discontiguous sublocations **Head>Face>Cheek/nose>Maxillary process of zygomatic** → ipsi/contra discontiguous sublocations **Head>Face>Cheek/nose>Zygomatic process of temporal bone** → ipsi/contra discontiguous sublocations **Head>Face>Cheek/nose>Nose** **Head>Face>Cheek/nose>Nose>Nose root** **Head>Face>Cheek/nose>Nose>Nose ridge** **Head>Face>Cheek/nose>Nose>Nose tip** (undecided if any sub-areas will apply) **Head>Face>Cheek/nose>Nose>Septum** **Head>Face>Below nose / philtrum** **Head>Face>Mouth** **Head>Face>Mouth>Lips** **Head>Face>Mouth>Lips>Upper lip** **Head>Face>Mouth>Lips>Lower lip** **Head>Face>Mouth>Corner of mouth** → ipsi/contra discontiguous sublocations (the ipsi/contra sublocations do not allow any sub-areas or surfaces) **Head>Face>Mouth>Teeth** (not allowed to select upper or lower sub-area) **Head>Face>Mouth>Teeth>Upper teeth** **Head>Face>Mouth>Teeth>Lower teeth** **Head>Face>Mouth>Tongue** (the only head location to allow surfaces: anterior, top and bottom; maybe 'ipsi' and 'contra'? and tip?) **Head>Face>Ear** → ipsi/contra discontiguous sublocations **Head>Face>Ear>Mastoid process** → ipsi/contra discontiguous sublocations **Head>Face>Ear>Earlobe** → ipsi/contra discontiguous sublocations **Head>Face>Jaw** → ipsi/contra discontiguous sublocations **Head>Face>Chin** **Head>Face>Under chin** (no sub-areas or surfaces allowed) .. _neck_location: Neck ==== surfaces: anterior, posterior, maybe ipsi & contra? sub-areas: all .. _torso_locations: Torso ===== (assume surfaces are not allowed for torso locations unless otherwise indicated. assume all sub-areas are allowed.) surfaces: anterior, posterior, lateral .. _shoulder_location: Torso>Shoulder ~~~~~~~~~~~~~~ surfaces: anterior, posterior, lateral → ipsi/contra discontiguous sublocations surfaces: anterior, posterior, lateral .. _armpit_location: Torso>Armpit ~~~~~~~~~~~~ (no sub-areas allowed) → ipsi/contra discontiguous sublocations (no sub-areas allowed) .. _sternum_clavicle: Torso>Sternum/clavicle area ~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. _chest_breast: Torso>Chest/breast area ~~~~~~~~~~~~~~~~~~~~~~~ .. _abdomen_waist: Torso>Abdominal/waist area ~~~~~~~~~~~~~~~~~~~~~~~~~~ .. _pelvis_area: Torso>Pelvis area ~~~~~~~~~~~~~~~~~ .. _hip_location: Torso>Hip ~~~~~~~~~ surfaces: anterior, posterior, lateral → ipsi/contra discontiguous sublocations surfaces: anterior, posterior, lateral .. _groin_location: Torso>Groin ~~~~~~~~~~~ (unsure whether sub-areas will be allowed) .. _buttocks_location: Torso>Buttocks ~~~~~~~~~~~~~~ → ipsi/contra discontiguous sublocations .. _contra_arm_locations: Contralateral arm ================= (assume all sub-areas are allowed for contra arm locations, and assume the allowable surfaces are Anterior, Posterior, Lateral, and Medial unless otherwise indicated.) (no sub-areas are allowed for this location) .. _upper_arm_locations: Arm (contralateral)>Upper arm ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ **Arm (contralateral)>Upper arm>Upper arm above bicep** **Arm (contralateral)>Upper arm>Bicep** .. _elbow_location: Arm (contralateral)>Elbow ~~~~~~~~~~~~~~~~~~~~~~~~~ .. _forearm_location: Arm (contralateral)>Forearm ~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. _wrist_location: Arm (contralateral)>Wrist ~~~~~~~~~~~~~~~~~~~~~~~~~ .. _legs_feet_locations: Legs and feet ============= (assume all sub-areas are allowed for legs and feet locations, and assume the allowable surfaces are Anterior, Posterior, Lateral, and Medial unless otherwise indicated.) surfaces: Anterior, Posterior, Lateral, Medial, Top, and Bottom .. _upper_leg_location: Legs and feet>Upper leg ~~~~~~~~~~~~~~~~~~~~~~~ → ipsi/contra discontiguous sublocations .. _knee_location: Legs and feet>Knee ~~~~~~~~~~~~~~~~~~ → ipsi/contra discontiguous sublocations .. _lower_leg_location: Legs and feet>Lower leg ~~~~~~~~~~~~~~~~~~~~~~~ → ipsi/contra discontiguous sublocations .. _ankle_location: Legs and feet>Ankle ~~~~~~~~~~~~~~~~~~~ → ipsi/contra discontiguous sublocations .. _foot_location: Legs and feet>Foot ~~~~~~~~~~~~~~~~~~ surfaces: Anterior, Posterior, Lateral, Medial, Top, and Bottom → ipsi/contra discontiguous sublocations surfaces: Anterior, Posterior, Lateral, Medial, Top, and Bottom .. _hand_location_list: 2. Hand locations ````````````````` **(Add description: as applicable to the same two location types in Location and also in the Hand Part module. I think Hand Configuration is handled separately, but I'm not sure.)** .. note:: **Joints and surfaces** Allow surface specification (default set if yes = back, friction, radial, ulnar) * new sub-area menu for 'whole hand' and 'hand minus fingers' in addition to the surfaces * sub-areas: finger side, wrist side, radial side, ulnar side, centre * none of the bone / joint options are available for these two locations Allow bone / joint specification (default set if yes = metacarpophalangeal joint, proximal bone, proximal interphalangeal joint, medial bone, distal interphalangeal joint, distal bone, tip) * options other than the two mentioned above use some subset of the bone/joint and hand surfaces list * these do not use the sub-areas list from above * include both the shortened and full versions of joint names * mcp = metacarpophalangeal joint * pip = proximal interphalangeal joint * dip = distal interphalangeal joint * Whole hand * all surfaces, all sub-areas * Hand minus fingers * all surfaces, all sub-areas **(The following areas use a subset of the bone / joint list, and none of the sub-area list. Assume all surfaces and bone/joints are allowed unless mentioned otherwise.)** * Heel of hand * (bone/joints: none allowed for this location) * Thumb * bone/joints: metacarpophalangeal joint, proximal bone, distal interphalangeal joint, distal bone, tip * Fingers * Selected fingers * Selected fingers and thumb * bone/joints: metacarpophalangeal joint, proximal bone, distal interphalangeal joint, distal bone, tip * Finger 1 * Finger 2 * Finger 3 * Finger 4 * Between thumb and finger 1 * surfaces: back and friction only * Between finger 1 and 2 * surfaces: back and friction only * Between finger 2 and 3 * surfaces: back and friction only * Between finger 3 and 4 * surfaces: back and friction only