diff --git a/hed/__init__.py b/hed/__init__.py index 6d3bd21e5..02a4e226c 100644 --- a/hed/__init__.py +++ b/hed/__init__.py @@ -8,12 +8,33 @@ from hed.models.tabular_input import TabularInput from hed.models.sidecar import Sidecar from hed.models.definition_dict import DefinitionDict - +from hed.models.query_handler import QueryHandler +from hed.models.query_service import get_query_handlers, search_strings from hed.schema.hed_schema import HedSchema from hed.schema.hed_schema_group import HedSchemaGroup from hed.schema.hed_schema_io import load_schema, load_schema_version +from hed.tools.bids.bids_dataset import BidsDataset +from hed.tools.analysis.event_manager import EventManager +from hed.tools.analysis.file_dictionary import FileDictionary +from hed.tools.analysis.hed_tag_manager import HedTagManager +from hed.tools.analysis.hed_type_defs import HedTypeDefs +from hed.tools.analysis.hed_type_factors import HedTypeFactors +from hed.tools.analysis.hed_type import HedType +from hed.tools.analysis.hed_type_manager import HedTypeManager +from hed.tools.analysis.hed_type_counts import HedTypeCount +from hed.tools.analysis.key_map import KeyMap +from hed.tools.analysis.tabular_summary import TabularSummary +from hed.tools.analysis.temporal_event import TemporalEvent +from hed.tools.analysis.hed_tag_manager import HedTagManager +from hed.tools.analysis.annotation_util import (check_df_columns, extract_tags, generate_sidecar_entry, + get_bids_dataset, hed_to_df, df_to_hed, merge_hed_dict, str_to_tabular, strs_to_sidecar, to_strlist) + +from hed.tools.util.hed_logger import HedLogger +from hed.tools.util.data_util import get_new_dataframe, get_value_dict, replace_values, reorder_columns +from hed.tools.util.io_util import check_filename, clean_filename, extract_suffix_path, get_file_list, make_path +from hed.tools.util.io_util import get_dir_dictionary, get_file_list, get_path_components, parse_bids_filename from . import _version __version__ = _version.get_versions()['version'] diff --git a/hed/models/__init__.py b/hed/models/__init__.py index 1e323766b..f89ea85be 100644 --- a/hed/models/__init__.py +++ b/hed/models/__init__.py @@ -6,6 +6,7 @@ from .definition_dict import DefinitionDict from .definition_entry import DefinitionEntry from .query_handler import QueryHandler +from .query_service import get_query_handlers, search_strings from .hed_group import HedGroup from .spreadsheet_input import SpreadsheetInput from .hed_string import HedString diff --git a/hed/schema/schema_compare.py b/hed/schema/schema_compare.py index 4a9216520..d30771525 100644 --- a/hed/schema/schema_compare.py +++ b/hed/schema/schema_compare.py @@ -1,3 +1,6 @@ +""" Functions supporting comparison of schemas. """ + + from hed.schema.hed_schema import HedKey from hed.schema.hed_schema_constants import HedSectionKey from collections import defaultdict diff --git a/hed/schema/schema_data/HED_testlib_2.0.0.xml b/hed/schema/schema_data/HED_testlib_2.0.0.xml index f5895bb4a..03be494ba 100644 --- a/hed/schema/schema_data/HED_testlib_2.0.0.xml +++ b/hed/schema/schema_data/HED_testlib_2.0.0.xml @@ -1,6 +1,6 @@ - This schema tests the ordering effects of various combinations of rooted and extension allowed for rooted schemas. + This schema tests the ordering effects of various combinations of rooted and extension allowed for rooted schemas. It is compatible with testlib version 3.0.0 but not testlib 2.0.0. Event @@ -139,35 +139,6 @@ - - C-nonextension - These should not be sorted. C should be last - - inLibrary - testlib - - - SubnodeC3 - - inLibrary - testlib - - - - SubnodeC1 - - inLibrary - testlib - - - - SubnodeC2 - - inLibrary - testlib - - - Action Do something. @@ -874,7 +845,7 @@ - A-extensionallowed + D-extensionallowed These should be sorted. This section should be first. extensionAllowed @@ -905,38 +876,6 @@ - - B-extensionallowed - These should be sorted. This section should be second. - - extensionAllowed - - - inLibrary - testlib - - - SubnodeE1 - - inLibrary - testlib - - - - SubnodeE2 - - inLibrary - testlib - - - - SubnodeE3 - - inLibrary - testlib - - - Item An independently existing thing (living or nonliving). @@ -7516,4 +7455,5 @@ Indicates that the schema attribute is meant to be applied to value classes. + A final section. diff --git a/hed/schema/schema_data/HED_testlib_2.1.0.xml b/hed/schema/schema_data/HED_testlib_2.1.0.xml new file mode 100644 index 000000000..3c7dfc33f --- /dev/null +++ b/hed/schema/schema_data/HED_testlib_2.1.0.xml @@ -0,0 +1,7426 @@ + + + This schema is designed to conflict with testlib 2.0.0 and testlib 3.0.0. + + + Event + Something that happens at a given time and (typically) place. Elements of this tag subtree designate the general category in which an event falls. + + suggestedTag + Task-property + + + Sensory-event + Something perceivable by the participant. An event meant to be an experimental stimulus should include the tag Task-property/Task-event-role/Experimental-stimulus. + + suggestedTag + Task-event-role + Sensory-presentation + + + + Agent-action + Any action engaged in by an agent (see the Agent subtree for agent categories). A participant response to an experiment stimulus should include the tag Agent-property/Agent-task-role/Experiment-participant. + + suggestedTag + Task-event-role + Agent + + + + Data-feature + An event marking the occurrence of a data feature such as an interictal spike or alpha burst that is often added post hoc to the data record. + + suggestedTag + Data-property + + + + Experiment-control + An event pertaining to the physical control of the experiment during its operation. + + + Experiment-procedure + An event indicating an experimental procedure, as in performing a saliva swab during the experiment or administering a survey. + + + Experiment-structure + An event specifying a change-point of the structure of experiment. This event is typically used to indicate a change in experimental conditions or tasks. + + + Measurement-event + A discrete measure returned by an instrument. + + suggestedTag + Data-property + + + + + Agent + Someone or something that takes an active role or produces a specified effect.The role or effect may be implicit. Being alive or performing an activity such as a computation may qualify something to be an agent. An agent may also be something that simulates something else. + + suggestedTag + Agent-property + + + Animal-agent + An agent that is an animal. + + + Avatar-agent + An agent associated with an icon or avatar representing another agent. + + + Controller-agent + An agent experiment control software or hardware. + + + Human-agent + A person who takes an active role or produces a specified effect. + + + Robotic-agent + An agent mechanical device capable of performing a variety of often complex tasks on command or by being programmed in advance. + + + Software-agent + An agent computer program. + + + + BA-nonextension + Does not conflict with testlib 2.0.0 or 3.0.0 + + inLibrary + testlib + + + SubnodeB1A + + inLibrary + testlib + + + + SubnodeB2A + + inLibrary + testlib + + + + + A-nonextension + These should not be sorted. A should be second. Conflicts with testlib 2.0.0. + + inLibrary + testlib + + + SubnodeA3 + + inLibrary + testlib + + + + SubnodeA1 + + inLibrary + testlib + + + + SubnodeA2 + + inLibrary + testlib + + + + + Action + Do something. + + extensionAllowed + + + Communicate + Convey knowledge of or information about something. + + Communicate-gesturally + Communicate nonverbally using visible bodily actions, either in place of speech or together and in parallel with spoken words. Gestures include movement of the hands, face, or other parts of the body. + + relatedTag + Move-face + Move-upper-extremity + + + Clap-hands + Strike the palms of against one another resoundingly, and usually repeatedly, especially to express approval. + + + Clear-throat + Cough slightly so as to speak more clearly, attract attention, or to express hesitancy before saying something awkward. + + relatedTag + Move-face + Move-head + + + + Frown + Express disapproval, displeasure, or concentration, typically by turning down the corners of the mouth. + + relatedTag + Move-face + + + + Grimace + Make a twisted expression, typically expressing disgust, pain, or wry amusement. + + relatedTag + Move-face + + + + Nod-head + Tilt head in alternating up and down arcs along the sagittal plane. It is most commonly, but not universally, used to indicate agreement, acceptance, or acknowledgement. + + relatedTag + Move-head + + + + Pump-fist + Raise with fist clenched in triumph or affirmation. + + relatedTag + Move-upper-extremity + + + + Raise-eyebrows + Move eyebrows upward. + + relatedTag + Move-face + Move-eyes + + + + Shake-fist + Clench hand into a fist and shake to demonstrate anger. + + relatedTag + Move-upper-extremity + + + + Shake-head + Turn head from side to side as a way of showing disagreement or refusal. + + relatedTag + Move-head + + + + Shhh + Place finger over lips and possibly uttering the syllable shhh to indicate the need to be quiet. + + relatedTag + Move-upper-extremity + + + + Shrug + Lift shoulders up towards head to indicate a lack of knowledge about a particular topic. + + relatedTag + Move-upper-extremity + Move-torso + + + + Smile + Form facial features into a pleased, kind, or amused expression, typically with the corners of the mouth turned up and the front teeth exposed. + + relatedTag + Move-face + + + + Spread-hands + Spread hands apart to indicate ignorance. + + relatedTag + Move-upper-extremity + + + + Thumb-up + Extend the thumb upward to indicate approval. + + relatedTag + Move-upper-extremity + + + + Thumbs-down + Extend the thumb downward to indicate disapproval. + + relatedTag + Move-upper-extremity + + + + Wave + Raise hand and move left and right, as a greeting or sign of departure. + + relatedTag + Move-upper-extremity + + + + Widen-eyes + Open eyes and possibly with eyebrows lifted especially to express surprise or fear. + + relatedTag + Move-face + Move-eyes + + + + Wink + Close and open one eye quickly, typically to indicate that something is a joke or a secret or as a signal of affection or greeting. + + relatedTag + Move-face + Move-eyes + + + + + Communicate-musically + Communicate using music. + + Hum + Make a low, steady continuous sound like that of a bee. Sing with the lips closed and without uttering speech. + + + Play-instrument + Make musical sounds using an instrument. + + + Sing + Produce musical tones by means of the voice. + + + Vocalize + Utter vocal sounds. + + + Whistle + Produce a shrill clear sound by forcing breath out or air in through the puckered lips. + + + + Communicate-vocally + Communicate using mouth or vocal cords. + + Cry + Shed tears associated with emotions, usually sadness but also joy or frustration. + + + Groan + Make a deep inarticulate sound in response to pain or despair. + + + Laugh + Make the spontaneous sounds and movements of the face and body that are the instinctive expressions of lively amusement and sometimes also of contempt or derision. + + + Scream + Make loud, vociferous cries or yells to express pain, excitement, or fear. + + + Shout + Say something very loudly. + + + Sigh + Emit a long, deep, audible breath expressing sadness, relief, tiredness, or a similar feeling. + + + Speak + Communicate using spoken language. + + + Whisper + Speak very softly using breath without vocal cords. + + + + + Move + Move in a specified direction or manner. Change position or posture. + + Breathe + Inhale or exhale during respiration. + + Blow + Expel air through pursed lips. + + + Cough + Suddenly and audibly expel air from the lungs through a partially closed glottis, preceded by inhalation. + + + Exhale + Blow out or expel breath. + + + Hiccup + Involuntarily spasm the diaphragm and respiratory organs, with a sudden closure of the glottis and a characteristic sound like that of a cough. + + + Hold-breath + Interrupt normal breathing by ceasing to inhale or exhale. + + + Inhale + Draw in with the breath through the nose or mouth. + + + Sneeze + Suddenly and violently expel breath through the nose and mouth. + + + Sniff + Draw in air audibly through the nose to detect a smell, to stop it from running, or to express contempt. + + + + Move-body + Move entire body. + + Bend + Move body in a bowed or curved manner. + + + Dance + Perform a purposefully selected sequences of human movement often with aesthetic or symbolic value. Move rhythmically to music, typically following a set sequence of steps. + + + Fall-down + Lose balance and collapse. + + + Flex + Cause a muscle to stand out by contracting or tensing it. Bend a limb or joint. + + + Jerk + Make a quick, sharp, sudden movement. + + + Lie-down + Move to a horizontal or resting position. + + + Recover-balance + Return to a stable, upright body position. + + + Shudder + Tremble convulsively, sometimes as a result of fear or revulsion. + + + Sit-down + Move from a standing to a sitting position. + + + Sit-up + Move from lying down to a sitting position. + + + Stand-up + Move from a sitting to a standing position. + + + Stretch + Straighten or extend body or a part of body to its full length, typically so as to tighten muscles or in order to reach something. + + + Stumble + Trip or momentarily lose balance and almost fall. + + + Turn + Change or cause to change direction. + + + + Move-body-part + Move one part of a body. + + Move-eyes + Move eyes. + + Blink + Shut and open the eyes quickly. + + + Close-eyes + Lower and keep eyelids in a closed position. + + + Fixate + Direct eyes to a specific point or target. + + + Inhibit-blinks + Purposely prevent blinking. + + + Open-eyes + Raise eyelids to expose pupil. + + + Saccade + Move eyes rapidly between fixation points. + + + Squint + Squeeze one or both eyes partly closed in an attempt to see more clearly or as a reaction to strong light. + + + Stare + Look fixedly or vacantly at someone or something with eyes wide open. + + + + Move-face + Move the face or jaw. + + Bite + Seize with teeth or jaws an object or organism so as to grip or break the surface covering. + + + Burp + Noisily release air from the stomach through the mouth. Belch. + + + Chew + Repeatedly grinding, tearing, and or crushing with teeth or jaws. + + + Gurgle + Make a hollow bubbling sound like that made by water running out of a bottle. + + + Swallow + Cause or allow something, especially food or drink to pass down the throat. + + Gulp + Swallow quickly or in large mouthfuls, often audibly, sometimes to indicate apprehension. + + + + Yawn + Take a deep involuntary inhalation with the mouth open often as a sign of drowsiness or boredom. + + + + Move-head + Move head. + + Lift-head + Tilt head back lifting chin. + + + Lower-head + Move head downward so that eyes are in a lower position. + + + Turn-head + Rotate head horizontally to look in a different direction. + + + + Move-lower-extremity + Move leg and/or foot. + + Curl-toes + Bend toes sometimes to grip. + + + Hop + Jump on one foot. + + + Jog + Run at a trot to exercise. + + + Jump + Move off the ground or other surface through sudden muscular effort in the legs. + + + Kick + Strike out or flail with the foot or feet. Strike using the leg, in unison usually with an area of the knee or lower using the foot. + + + Pedal + Move by working the pedals of a bicycle or other machine. + + + Press-foot + Move by pressing foot. + + + Run + Travel on foot at a fast pace. + + + Step + Put one leg in front of the other and shift weight onto it. + + Heel-strike + Strike the ground with the heel during a step. + + + Toe-off + Push with toe as part of a stride. + + + + Trot + Run at a moderate pace, typically with short steps. + + + Walk + Move at a regular pace by lifting and setting down each foot in turn never having both feet off the ground at once. + + + + Move-torso + Move body trunk. + + + Move-upper-extremity + Move arm, shoulder, and/or hand. + + Drop + Let or cause to fall vertically. + + + Grab + Seize suddenly or quickly. Snatch or clutch. + + + Grasp + Seize and hold firmly. + + + Hold-down + Prevent someone or something from moving by holding them firmly. + + + Lift + Raising something to higher position. + + + Make-fist + Close hand tightly with the fingers bent against the palm. + + + Point + Draw attention to something by extending a finger or arm. + + + Press + Apply pressure to something to flatten, shape, smooth or depress it. This action tag should be used to indicate key presses and mouse clicks. + + relatedTag + Push + + + + Push + Apply force in order to move something away. Use Press to indicate a key press or mouse click. + + relatedTag + Press + + + + Reach + Stretch out your arm in order to get or touch something. + + + Release + Make available or set free. + + + Retract + Draw or pull back. + + + Scratch + Drag claws or nails over a surface or on skin. + + + Snap-fingers + Make a noise by pushing second finger hard against thumb and then releasing it suddenly so that it hits the base of the thumb. + + + Touch + Come into or be in contact with. + + + + + + Perceive + Produce an internal, conscious image through stimulating a sensory system. + + Hear + Give attention to a sound. + + + See + Direct gaze toward someone or something or in a specified direction. + + + Sense-by-touch + Sense something through receptors in the skin. + + + Smell + Inhale in order to ascertain an odor or scent. + + + Taste + Sense a flavor in the mouth and throat on contact with a substance. + + + + Perform + Carry out or accomplish an action, task, or function. + + Close + Act as to blocked against entry or passage. + + + Collide-with + Hit with force when moving. + + + Halt + Bring or come to an abrupt stop. + + + Modify + Change something. + + + Open + Widen an aperture, door, or gap, especially one allowing access to something. + + + Operate + Control the functioning of a machine, process, or system. + + + Play + Engage in activity for enjoyment and recreation rather than a serious or practical purpose. + + + Read + Interpret something that is written or printed. + + + Repeat + Make do or perform again. + + + Rest + Be inactive in order to regain strength, health, or energy. + + + Write + Communicate or express by means of letters or symbols written or imprinted on a surface. + + + + Think + Direct the mind toward someone or something or use the mind actively to form connected ideas. + + Allow + Allow access to something such as allowing a car to pass. + + + Attend-to + Focus mental experience on specific targets. + + + Count + Tally items either silently or aloud. + + + Deny + Refuse to give or grant something requested or desired by someone. + + + Detect + Discover or identify the presence or existence of something. + + + Discriminate + Recognize a distinction. + + + Encode + Convert information or an instruction into a particular form. + + + Evade + Escape or avoid, especially by cleverness or trickery. + + + Generate + Cause something, especially an emotion or situation to arise or come about. + + + Identify + Establish or indicate who or what someone or something is. + + + Imagine + Form a mental image or concept of something. + + + Judge + Evaluate evidence to make a decision or form a belief. + + + Learn + Adaptively change behavior as the result of experience. + + + Memorize + Adaptively change behavior as the result of experience. + + + Plan + Think about the activities required to achieve a desired goal. + + + Predict + Say or estimate that something will happen or will be a consequence of something without having exact informaton. + + + Recall + Remember information by mental effort. + + + Recognize + Identify someone or something from having encountered them before. + + + Respond + React to something such as a treatment or a stimulus. + + + Switch-attention + Transfer attention from one focus to another. + + + Track + Follow a person, animal, or object through space or time. + + + + + Item + An independently existing thing (living or nonliving). + + extensionAllowed + + + Biological-item + An entity that is biological, that is related to living organisms. + + Anatomical-item + A biological structure, system, fluid or other substance excluding single molecular entities. + + Body + The biological structure representing an organism. + + + Body-part + Any part of an organism. + + Head + The upper part of the human body, or the front or upper part of the body of an animal, typically separated from the rest of the body by a neck, and containing the brain, mouth, and sense organs. + + Ear + A sense organ needed for the detection of sound and for establishing balance. + + + Face + The anterior portion of the head extending from the forehead to the chin and ear to ear. The facial structures contain the eyes, nose and mouth, cheeks and jaws. + + Cheek + The fleshy part of the face bounded by the eyes, nose, ear, and jaw line. + + + Chin + The part of the face below the lower lip and including the protruding part of the lower jaw. + + + Eye + The organ of sight or vision. + + + Eyebrow + The arched strip of hair on the bony ridge above each eye socket. + + + Forehead + The part of the face between the eyebrows and the normal hairline. + + + Lip + Fleshy fold which surrounds the opening of the mouth. + + + Mouth + The proximal portion of the digestive tract, containing the oral cavity and bounded by the oral opening. + + + Nose + A structure of special sense serving as an organ of the sense of smell and as an entrance to the respiratory tract. + + + Teeth + The hard bonelike structures in the jaws. A collection of teeth arranged in some pattern in the mouth or other part of the body. + + + + Hair + The filamentous outgrowth of the epidermis. + + + + Lower-extremity + Refers to the whole inferior limb (leg and/or foot). + + Ankle + A gliding joint between the distal ends of the tibia and fibula and the proximal end of the talus. + + + Calf + The fleshy part at the back of the leg below the knee. + + + Foot + The structure found below the ankle joint required for locomotion. + + Big-toe + The largest toe on the inner side of the foot. + + + Heel + The back of the foot below the ankle. + + + Instep + The part of the foot between the ball and the heel on the inner side. + + + Little-toe + The smallest toe located on the outer side of the foot. + + + Toes + The terminal digits of the foot. + + + + Knee + A joint connecting the lower part of the femur with the upper part of the tibia. + + + Shin + Front part of the leg below the knee. + + + Thigh + Upper part of the leg between hip and knee. + + + + Torso + The body excluding the head and neck and limbs. + + Buttocks + The round fleshy parts that form the lower rear area of a human trunk. + + + Gentalia + The external organs of reproduction. + + deprecatedFrom + 8.1.0 + + + + Hip + The lateral prominence of the pelvis from the waist to the thigh. + + + Torso-back + The rear surface of the human body from the shoulders to the hips. + + + Torso-chest + The anterior side of the thorax from the neck to the abdomen. + + + Waist + The abdominal circumference at the navel. + + + + Upper-extremity + Refers to the whole superior limb (shoulder, arm, elbow, wrist, hand). + + Elbow + A type of hinge joint located between the forearm and upper arm. + + + Forearm + Lower part of the arm between the elbow and wrist. + + + Hand + The distal portion of the upper extremity. It consists of the carpus, metacarpus, and digits. + + Finger + Any of the digits of the hand. + + Index-finger + The second finger from the radial side of the hand, next to the thumb. + + + Little-finger + The fifth and smallest finger from the radial side of the hand. + + + Middle-finger + The middle or third finger from the radial side of the hand. + + + Ring-finger + The fourth finger from the radial side of the hand. + + + Thumb + The thick and short hand digit which is next to the index finger in humans. + + + + Knuckles + A part of a finger at a joint where the bone is near the surface, especially where the finger joins the hand. + + + Palm + The part of the inner surface of the hand that extends from the wrist to the bases of the fingers. + + + + Shoulder + Joint attaching upper arm to trunk. + + + Upper-arm + Portion of arm between shoulder and elbow. + + + Wrist + A joint between the distal end of the radius and the proximal row of carpal bones. + + + + + + Organism + A living entity, more specifically a biological entity that consists of one or more cells and is capable of genomic replication (independently or not). + + Animal + A living organism that has membranous cell walls, requires oxygen and organic foods, and is capable of voluntary movement. + + + Human + The bipedal primate mammal Homo sapiens. + + + Plant + Any living organism that typically synthesizes its food from inorganic substances and possesses cellulose cell walls. + + + + + Language-item + An entity related to a systematic means of communicating by the use of sounds, symbols, or gestures. + + suggestedTag + Sensory-presentation + + + Character + A mark or symbol used in writing. + + + Clause + A unit of grammatical organization next below the sentence in rank, usually consisting of a subject and predicate. + + + Glyph + A hieroglyphic character, symbol, or pictograph. + + + Nonword + A group of letters or speech sounds that looks or sounds like a word but that is not accepted as such by native speakers. + + + Paragraph + A distinct section of a piece of writing, usually dealing with a single theme. + + + Phoneme + A speech sound that is distinguished by the speakers of a particular language. + + + Phrase + A phrase is a group of words functioning as a single unit in the syntax of a sentence. + + + Sentence + A set of words that is complete in itself, conveying a statement, question, exclamation, or command and typically containing an explicit or implied subject and a predicate containing a finite verb. + + + Syllable + A unit of spoken language larger than a phoneme. + + + Textblock + A block of text. + + + Word + A word is the smallest free form (an item that may be expressed in isolation with semantic or pragmatic content) in a language. + + + + Object + Something perceptible by one or more of the senses, especially by vision or touch. A material thing. + + suggestedTag + Sensory-presentation + + + Geometric-object + An object or a representation that has structure and topology in space. + + 2D-shape + A planar, two-dimensional shape. + + Arrow + A shape with a pointed end indicating direction. + + + Clockface + The dial face of a clock. A location identifier based on clockface numbering or anatomic subregion. + + + Cross + A figure or mark formed by two intersecting lines crossing at their midpoints. + + + Dash + A horizontal stroke in writing or printing to mark a pause or break in sense or to represent omitted letters or words. + + + Ellipse + A closed plane curve resulting from the intersection of a circular cone and a plane cutting completely through it, especially a plane not parallel to the base. + + Circle + A ring-shaped structure with every point equidistant from the center. + + + + Rectangle + A parallelogram with four right angles. + + Square + A square is a special rectangle with four equal sides. + + + + Single-point + A point is a geometric entity that is located in a zero-dimensional spatial region and whose position is defined by its coordinates in some coordinate system. + + + Star + A conventional or stylized representation of a star, typically one having five or more points. + + + Triangle + A three-sided polygon. + + + + 3D-shape + A geometric three-dimensional shape. + + Box + A square or rectangular vessel, usually made of cardboard or plastic. + + Cube + A solid or semi-solid in the shape of a three dimensional square. + + + + Cone + A shape whose base is a circle and whose sides taper up to a point. + + + Cylinder + A surface formed by circles of a given radius that are contained in a plane perpendicular to a given axis, whose centers align on the axis. + + + Ellipsoid + A closed plane curve resulting from the intersection of a circular cone and a plane cutting completely through it, especially a plane not parallel to the base. + + Sphere + A solid or hollow three-dimensional object bounded by a closed surface such that every point on the surface is equidistant from the center. + + + + Pyramid + A polyhedron of which one face is a polygon of any number of sides, and the other faces are triangles with a common vertex. + + + + Pattern + An arrangement of objects, facts, behaviors, or other things which have scientific, mathematical, geometric, statistical, or other meaning. + + Dots + A small round mark or spot. + + + LED-pattern + A pattern created by lighting selected members of a fixed light emitting diode array. + + + + + Ingestible-object + Something that can be taken into the body by the mouth for digestion or absorption. + + + Man-made-object + Something constructed by human means. + + Building + A structure that has a roof and walls and stands more or less permanently in one place. + + Attic + A room or a space immediately below the roof of a building. + + + Basement + The part of a building that is wholly or partly below ground level. + + + Entrance + The means or place of entry. + + + Roof + A roof is the covering on the uppermost part of a building which provides protection from animals and weather, notably rain, but also heat, wind and sunlight. + + + Room + An area within a building enclosed by walls and floor and ceiling. + + + + Clothing + A covering designed to be worn on the body. + + + Device + An object contrived for a specific purpose. + + Assistive-device + A device that help an individual accomplish a task. + + Glasses + Frames with lenses worn in front of the eye for vision correction, eye protection, or protection from UV rays. + + + Writing-device + A device used for writing. + + Pen + A common writing instrument used to apply ink to a surface for writing or drawing. + + + Pencil + An implement for writing or drawing that is constructed of a narrow solid pigment core in a protective casing that prevents the core from being broken or marking the hand. + + + + + Computing-device + An electronic device which take inputs and processes results from the inputs. + + Cellphone + A telephone with access to a cellular radio system so it can be used over a wide area, without a physical connection to a network. + + + Desktop-computer + A computer suitable for use at an ordinary desk. + + + Laptop-computer + A computer that is portable and suitable for use while traveling. + + + Tablet-computer + A small portable computer that accepts input directly on to its screen rather than via a keyboard or mouse. + + + + Engine + A motor is a machine designed to convert one or more forms of energy into mechanical energy. + + + IO-device + Hardware used by a human (or other system) to communicate with a computer. + + Input-device + A piece of equipment used to provide data and control signals to an information processing system such as a computer or information appliance. + + Computer-mouse + A hand-held pointing device that detects two-dimensional motion relative to a surface. + + Mouse-button + An electric switch on a computer mouse which can be pressed or clicked to select or interact with an element of a graphical user interface. + + + Scroll-wheel + A scroll wheel or mouse wheel is a wheel used for scrolling made of hard plastic with a rubbery surface usually located between the left and right mouse buttons and is positioned perpendicular to the mouse surface. + + + + Joystick + A control device that uses a movable handle to create two-axis input for a computer device. + + + Keyboard + A device consisting of mechanical keys that are pressed to create input to a computer. + + Keyboard-key + A button on a keyboard usually representing letters, numbers, functions, or symbols. + + # + Value of a keyboard key. + + takesValue + + + + + + Keypad + A device consisting of keys, usually in a block arrangement, that provides limited input to a system. + + Keypad-key + A key on a separate section of a computer keyboard that groups together numeric keys and those for mathematical or other special functions in an arrangement like that of a calculator. + + # + Value of keypad key. + + takesValue + + + + + + Microphone + A device designed to convert sound to an electrical signal. + + + Push-button + A switch designed to be operated by pressing a button. + + + + Output-device + Any piece of computer hardware equipment which converts information into human understandable form. + + Auditory-device + A device designed to produce sound. + + Headphones + An instrument that consists of a pair of small loudspeakers, or less commonly a single speaker, held close to ears and connected to a signal source such as an audio amplifier, radio, CD player or portable media player. + + + Loudspeaker + A device designed to convert electrical signals to sounds that can be heard. + + + + Display-device + An output device for presentation of information in visual or tactile form the latter used for example in tactile electronic displays for blind people. + + Computer-screen + An electronic device designed as a display or a physical device designed to be a protective meshwork. + + Screen-window + A part of a computer screen that contains a display different from the rest of the screen. A window is a graphical control element consisting of a visual area containing some of the graphical user interface of the program it belongs to and is framed by a window decoration. + + + + Head-mounted-display + An instrument that functions as a display device, worn on the head or as part of a helmet, that has a small display optic in front of one (monocular HMD) or each eye (binocular HMD). + + + LED-display + A LED display is a flat panel display that uses an array of light-emitting diodes as pixels for a video display. + + + + + Recording-device + A device that copies information in a signal into a persistent information bearer. + + EEG-recorder + A device for recording electric currents in the brain using electrodes applied to the scalp, to the surface of the brain, or placed within the substance of the brain. + + + File-storage + A device for recording digital information to a permanent media. + + + MEG-recorder + A device for measuring the magnetic fields produced by electrical activity in the brain, usually conducted externally. + + + Motion-capture + A device for recording the movement of objects or people. + + + Tape-recorder + A device for recording and reproduction usually using magnetic tape for storage that can be saved and played back. + + + + Touchscreen + A control component that operates an electronic device by pressing the display on the screen. + + + + Machine + A human-made device that uses power to apply forces and control movement to perform an action. + + + Measurement-device + A device in which a measure function inheres. + + Clock + A device designed to indicate the time of day or to measure the time duration of an event or action. + + Clock-face + A location identifier based on clockface numbering or anatomic subregion. + + + + + Robot + A mechanical device that sometimes resembles a living animal and is capable of performing a variety of often complex human tasks on command or by being programmed in advance. + + + Tool + A component that is not part of a device but is designed to support its assemby or operation. + + + + Document + A physical object, or electronic counterpart, that is characterized by containing writing which is meant to be human-readable. + + Book + A volume made up of pages fastened along one edge and enclosed between protective covers. + + + Letter + A written message addressed to a person or organization. + + + Note + A brief written record. + + + Notebook + A book for notes or memoranda. + + + Questionnaire + A document consisting of questions and possibly responses, depending on whether it has been filled out. + + + + Furnishing + Furniture, fittings, and other decorative accessories, such as curtains and carpets, for a house or room. + + + Manufactured-material + Substances created or extracted from raw materials. + + Ceramic + A hard, brittle, heat-resistant and corrosion-resistant material made by shaping and then firing a nonmetallic mineral, such as clay, at a high temperature. + + + Glass + A brittle transparent solid with irregular atomic structure. + + + Paper + A thin sheet material produced by mechanically or chemically processing cellulose fibres derived from wood, rags, grasses or other vegetable sources in water. + + + Plastic + Various high-molecular-weight thermoplastic or thermosetting polymers that are capable of being molded, extruded, drawn, or otherwise shaped and then hardened into a form. + + + Steel + An alloy made up of iron with typically a few tenths of a percent of carbon to improve its strength and fracture resistance compared to iron. + + + + Media + Media are audo/visual/audiovisual modes of communicating information for mass consumption. + + Media-clip + A short segment of media. + + Audio-clip + A short segment of audio. + + + Audiovisual-clip + A short media segment containing both audio and video. + + + Video-clip + A short segment of video. + + + + Visualization + An planned process that creates images, diagrams or animations from the input data. + + Animation + A form of graphical illustration that changes with time to give a sense of motion or represent dynamic changes in the portrayal. + + + Art-installation + A large-scale, mixed-media constructions, often designed for a specific place or for a temporary period of time. + + + Braille + A display using a system of raised dots that can be read with the fingers by people who are blind. + + + Image + Any record of an imaging event whether physical or electronic. + + Cartoon + A type of illustration, sometimes animated, typically in a non-realistic or semi-realistic style. The specific meaning has evolved over time, but the modern usage usually refers to either an image or series of images intended for satire, caricature, or humor. A motion picture that relies on a sequence of illustrations for its animation. + + + Drawing + A representation of an object or outlining a figure, plan, or sketch by means of lines. + + + Icon + A sign (such as a word or graphic symbol) whose form suggests its meaning. + + + Painting + A work produced through the art of painting. + + + Photograph + An image recorded by a camera. + + + + Movie + A sequence of images displayed in succession giving the illusion of continuous movement. + + + Outline-visualization + A visualization consisting of a line or set of lines enclosing or indicating the shape of an object in a sketch or diagram. + + + Point-light-visualization + A display in which action is depicted using a few points of light, often generated from discrete sensors in motion capture. + + + Sculpture + A two- or three-dimensional representative or abstract forms, especially by carving stone or wood or by casting metal or plaster. + + + Stick-figure-visualization + A drawing showing the head of a human being or animal as a circle and all other parts as straight lines. + + + + + Navigational-object + An object whose purpose is to assist directed movement from one location to another. + + Path + A trodden way. A way or track laid down for walking or made by continual treading. + + + Road + An open way for the passage of vehicles, persons, or animals on land. + + Lane + A defined path with physical dimensions through which an object or substance may traverse. + + + + Runway + A paved strip of ground on a landing field for the landing and takeoff of aircraft. + + + + Vehicle + A mobile machine which transports people or cargo. + + Aircraft + A vehicle which is able to travel through air in an atmosphere. + + + Bicycle + A human-powered, pedal-driven, single-track vehicle, having two wheels attached to a frame, one behind the other. + + + Boat + A watercraft of any size which is able to float or plane on water. + + + Car + A wheeled motor vehicle used primarily for the transportation of human passengers. + + + Cart + A cart is a vehicle which has two wheels and is designed to transport human passengers or cargo. + + + Tractor + A mobile machine specifically designed to deliver a high tractive effort at slow speeds, and mainly used for the purposes of hauling a trailer or machinery used in agriculture or construction. + + + Train + A connected line of railroad cars with or without a locomotive. + + + Truck + A motor vehicle which, as its primary funcion, transports cargo rather than human passangers. + + + + + Natural-object + Something that exists in or is produced by nature, and is not artificial or man-made. + + Mineral + A solid, homogeneous, inorganic substance occurring in nature and having a definite chemical composition. + + + Natural-feature + A feature that occurs in nature. A prominent or identifiable aspect, region, or site of interest. + + Field + An unbroken expanse as of ice or grassland. + + + Hill + A rounded elevation of limited extent rising above the surrounding land with local relief of less than 300m. + + + Mountain + A landform that extends above the surrounding terrain in a limited area. + + + River + A natural freshwater surface stream of considerable volume and a permanent or seasonal flow, moving in a definite channel toward a sea, lake, or another river. + + + Waterfall + A sudden descent of water over a step or ledge in the bed of a river. + + + + + + Sound + Mechanical vibrations transmitted by an elastic medium. Something that can be heard. + + Environmental-sound + Sounds occuring in the environment. An accumulation of noise pollution that occurs outside. This noise can be caused by transport, industrial, and recreational activities. + + Crowd-sound + Noise produced by a mixture of sounds from a large group of people. + + + Signal-noise + Any part of a signal that is not the true or original signal but is introduced by the communication mechanism. + + + + Musical-sound + Sound produced by continuous and regular vibrations, as opposed to noise. + + Instrument-sound + Sound produced by a musical instrument. + + Oboe-sound + These should be sorted. Oboe should be second + + rooted + Instrument-sound + + + inLibrary + testlib + + + Oboe-subsound1 + + inLibrary + testlib + + + + Oboe-subsound2 + + inLibrary + testlib + + + + + Piano-sound + Conflicts with testlib 3.0.0. + + rooted + Instrument-sound + + + inLibrary + testlib + + + Piano-subsound1 + + inLibrary + testlib + + + + Piano-subsound2A + + inLibrary + testlib + + + + + Violin1-sound + Conflicts with testlib 2.0.0 + + rooted + Instrument-sound + + + inLibrary + testlib + + + Violin-subsound1 + + inLibrary + testlib + + + + Violin-subsound2 + + inLibrary + testlib + + + + Violin1-subsound3 + + inLibrary + testlib + + + + + + Tone + A musical note, warble, or other sound used as a particular signal on a telephone or answering machine. + + + Vocalized-sound + Musical sound produced by vocal cords in a biological agent. + + + + Named-animal-sound + A sound recognizable as being associated with particular animals. + + Barking + Sharp explosive cries like sounds made by certain animals, especially a dog, fox, or seal. + + + Bleating + Wavering cries like sounds made by a sheep, goat, or calf. + + + Chirping + Short, sharp, high-pitched noises like sounds made by small birds or an insects. + + + Crowing + Loud shrill sounds characteristic of roosters. + + + Growling + Low guttural sounds like those that made in the throat by a hostile dog or other animal. + + + Meowing + Vocalizations like those made by as those cats. These sounds have diverse tones and are sometimes chattered, murmured or whispered. The purpose can be assertive. + + + Mooing + Deep vocal sounds like those made by a cow. + + + Purring + Low continuous vibratory sound such as those made by cats. The sound expresses contentment. + + + Roaring + Loud, deep, or harsh prolonged sounds such as those made by big cats and bears for long-distance communication and intimidation. + + + Squawking + Loud, harsh noises such as those made by geese. + + + + Named-object-sound + A sound identifiable as coming from a particular type of object. + + Alarm-sound + A loud signal often loud continuous ringing to alert people to a problem or condition that requires urgent attention. + + + Beep + A short, single tone, that is typically high-pitched and generally made by a computer or other machine. + + + Buzz + A persistent vibratory sound often made by a buzzer device and used to indicate something incorrect. + + + Click + The sound made by a mechanical cash register, often to designate a reward. + + + Ding + A short ringing sound such as that made by a bell, often to indicate a correct response or the expiration of time. + + + Horn-blow + A loud sound made by forcing air through a sound device that funnels air to create the sound, often used to sound an alert. + + + Ka-ching + The sound made by a mechanical cash register, often to designate a reward. + + + Siren + A loud, continuous sound often varying in frequency designed to indicate an emergency. + + + + + + Property + Something that pertains to a thing. A characteristic of some entity. A quality or feature regarded as a characteristic or inherent part of someone or something. HED attributes are adjectives or adverbs. + + extensionAllowed + + + Agent-property + Something that pertains to an agent. + + extensionAllowed + + + Agent-state + The state of the agent. + + Agent-cognitive-state + The state of the cognitive processes or state of mind of the agent. + + Alert + Condition of heightened watchfulness or preparation for action. + + + Anesthetized + Having lost sensation to pain or having senses dulled due to the effects of an anesthetic. + + + Asleep + Having entered a periodic, readily reversible state of reduced awareness and metabolic activity, usually accompanied by physical relaxation and brain activity. + + + Attentive + Concentrating and focusing mental energy on the task or surroundings. + + + Awake + In a non sleeping state. + + + Brain-dead + Characterized by the irreversible absence of cortical and brain stem functioning. + + + Comatose + In a state of profound unconsciousness associated with markedly depressed cerebral activity. + + + Distracted + Lacking in concentration because of being preoccupied. + + + Drowsy + In a state of near-sleep, a strong desire for sleep, or sleeping for unusually long periods. + + + Intoxicated + In a state with disturbed psychophysiological functions and responses as a result of administration or ingestion of a psychoactive substance. + + + Locked-in + In a state of complete paralysis of all voluntary muscles except for the ones that control the movements of the eyes. + + + Passive + Not responding or initiating an action in response to a stimulus. + + + Resting + A state in which the agent is not exhibiting any physical exertion. + + + Vegetative + A state of wakefulness and conscience, but (in contrast to coma) with involuntary opening of the eyes and movements (such as teeth grinding, yawning, or thrashing of the extremities). + + + + Agent-emotional-state + The status of the general temperament and outlook of an agent. + + Angry + Experiencing emotions characterized by marked annoyance or hostility. + + + Aroused + In a state reactive to stimuli leading to increased heart rate and blood pressure, sensory alertness, mobility and readiness to respond. + + + Awed + Filled with wonder. Feeling grand, sublime or powerful emotions characterized by a combination of joy, fear, admiration, reverence, and/or respect. + + + Compassionate + Feeling or showing sympathy and concern for others often evoked for a person who is in distress and associated with altruistic motivation. + + + Content + Feeling satisfaction with things as they are. + + + Disgusted + Feeling revulsion or profound disapproval aroused by something unpleasant or offensive. + + + Emotionally-neutral + Feeling neither satisfied nor dissatisfied. + + + Empathetic + Understanding and sharing the feelings of another. Being aware of, being sensitive to, and vicariously experiencing the feelings, thoughts, and experience of another. + + + Excited + Feeling great enthusiasm and eagerness. + + + Fearful + Feeling apprehension that one may be in danger. + + + Frustrated + Feeling annoyed as a result of being blocked, thwarted, disappointed or defeated. + + + Grieving + Feeling sorrow in response to loss, whether physical or abstract. + + + Happy + Feeling pleased and content. + + + Jealous + Feeling threatened by a rival in a relationship with another individual, in particular an intimate partner, usually involves feelings of threat, fear, suspicion, distrust, anxiety, anger, betrayal, and rejection. + + + Joyful + Feeling delight or intense happiness. + + + Loving + Feeling a strong positive emotion of affection and attraction. + + + Relieved + No longer feeling pain, distress, anxiety, or reassured. + + + Sad + Feeling grief or unhappiness. + + + Stressed + Experiencing mental or emotional strain or tension. + + + + Agent-physiological-state + Having to do with the mechanical, physical, or biochemical function of an agent. + + Healthy + Having no significant health-related issues. + + relatedTag + Sick + + + + Hungry + Being in a state of craving or desiring food. + + relatedTag + Sated + Thirsty + + + + Rested + Feeling refreshed and relaxed. + + relatedTag + Tired + + + + Sated + Feeling full. + + relatedTag + Hungry + + + + Sick + Being in a state of ill health, bodily malfunction, or discomfort. + + relatedTag + Healthy + + + + Thirsty + Feeling a need to drink. + + relatedTag + Hungry + + + + Tired + Feeling in need of sleep or rest. + + relatedTag + Rested + + + + + Agent-postural-state + Pertaining to the position in which agent holds their body. + + Crouching + Adopting a position where the knees are bent and the upper body is brought forward and down, sometimes to avoid detection or to defend oneself. + + + Eyes-closed + Keeping eyes closed with no blinking. + + + Eyes-open + Keeping eyes open with occasional blinking. + + + Kneeling + Positioned where one or both knees are on the ground. + + + On-treadmill + Ambulation on an exercise apparatus with an endless moving belt to support moving in place. + + + Prone + Positioned in a recumbent body position whereby the person lies on its stomach and faces downward. + + + Seated-with-chin-rest + Using a device that supports the chin and head. + + + Sitting + In a seated position. + + + Standing + Assuming or maintaining an erect upright position. + + + + + Agent-task-role + The function or part that is ascribed to an agent in performing the task. + + Experiment-actor + An agent who plays a predetermined role to create the experiment scenario. + + + Experiment-controller + An agent exerting control over some aspect of the experiment. + + + Experiment-participant + Someone who takes part in an activity related to an experiment. + + + Experimenter + Person who is the owner of the experiment and has its responsibility. + + + + Agent-trait + A genetically, environmentally, or socially determined characteristic of an agent. + + Age + Length of time elapsed time since birth of the agent. + + # + + takesValue + + + valueClass + numericClass + + + + + Agent-experience-level + Amount of skill or knowledge that the agent has as pertains to the task. + + Expert-level + Having comprehensive and authoritative knowledge of or skill in a particular area related to the task. + + relatedTag + Intermediate-experience-level + Novice-level + + + + Intermediate-experience-level + Having a moderate amount of knowledge or skill related to the task. + + relatedTag + Expert-level + Novice-level + + + + Novice-level + Being inexperienced in a field or situation related to the task. + + relatedTag + Expert-level + Intermediate-experience-level + + + + + Ethnicity + Belong to a social group that has a common national or cultural tradition. Use with Label to avoid extension. + + + Gender + Characteristics that are socially constructed, including norms, behaviors, and roles based on sex. + + + Handedness + Individual preference for use of a hand, known as the dominant hand. + + Ambidextrous + Having no overall dominance in the use of right or left hand or foot in the performance of tasks that require one hand or foot. + + + Left-handed + Preference for using the left hand or foot for tasks requiring the use of a single hand or foot. + + + Right-handed + Preference for using the right hand or foot for tasks requiring the use of a single hand or foot. + + + + Race + Belonging to a group sharing physical or social qualities as defined within a specified society. Use with Label to avoid extension. + + + Sex + Physical properties or qualities by which male is distinguished from female. + + Female + Biological sex of an individual with female sexual organs such ova. + + + Intersex + Having genitalia and/or secondary sexual characteristics of indeterminate sex. + + + Male + Biological sex of an individual with male sexual organs producing sperm. + + + + + + Data-property + Something that pertains to data or information. + + extensionAllowed + + + Data-marker + An indicator placed to mark something. + + Data-break-marker + An indicator place to indicate a gap in the data. + + + Temporal-marker + An indicator placed at a particular time in the data. + + Inset + Marks an intermediate point in an ongoing event of temporal extent. + + topLevelTagGroup + + + reserved + + + relatedTag + Onset + Offset + + + + Offset + Marks the end of an event of temporal extent. + + topLevelTagGroup + + + reserved + + + relatedTag + Onset + Inset + + + + Onset + Marks the start of an ongoing event of temporal extent. + + topLevelTagGroup + + + reserved + + + relatedTag + Inset + Offset + + + + Pause + Indicates the temporary interruption of the operation a process and subsequently wait for a signal to continue. + + + Time-out + A cancellation or cessation that automatically occurs when a predefined interval of time has passed without a certain event occurring. + + + Time-sync + A synchronization signal whose purpose to help synchronize different signals or processes. Often used to indicate a marker inserted into the recorded data to allow post hoc synchronization of concurrently recorded data streams. + + + + + Data-resolution + Smallest change in a quality being measured by an sensor that causes a perceptible change. + + Printer-resolution + Resolution of a printer, usually expressed as the number of dots-per-inch for a printer. + + # + + takesValue + + + valueClass + numericClass + + + + + Screen-resolution + Resolution of a screen, usually expressed as the of pixels in a dimension for a digital display device. + + # + + takesValue + + + valueClass + numericClass + + + + + Sensory-resolution + Resolution of measurements by a sensing device. + + # + + takesValue + + + valueClass + numericClass + + + + + Spatial-resolution + Linear spacing of a spatial measurement. + + # + + takesValue + + + valueClass + numericClass + + + + + Spectral-resolution + Measures the ability of a sensor to resolve features in the electromagnetic spectrum. + + # + + takesValue + + + valueClass + numericClass + + + + + Temporal-resolution + Measures the ability of a sensor to resolve features in time. + + # + + takesValue + + + valueClass + numericClass + + + + + + Data-source-type + The type of place, person, or thing from which the data comes or can be obtained. + + Computed-feature + A feature computed from the data by a tool. This tag should be grouped with a label of the form Toolname_propertyName. + + + Computed-prediction + A computed extrapolation of known data. + + + Expert-annotation + An explanatory or critical comment or other in-context information provided by an authority. + + + Instrument-measurement + Information obtained from a device that is used to measure material properties or make other observations. + + + Observation + Active acquisition of information from a primary source. Should be grouped with a label of the form AgentID_featureName. + + + + Data-value + Designation of the type of a data item. + + Categorical-value + Indicates that something can take on a limited and usually fixed number of possible values. + + Categorical-class-value + Categorical values that fall into discrete classes such as true or false. The grouping is absolute in the sense that it is the same for all participants. + + All + To a complete degree or to the full or entire extent. + + relatedTag + Some + None + + + + Correct + Free from error. Especially conforming to fact or truth. + + relatedTag + Wrong + + + + Explicit + Stated clearly and in detail, leaving no room for confusion or doubt. + + relatedTag + Implicit + + + + False + Not in accordance with facts, reality or definitive criteria. + + relatedTag + True + + + + Implicit + Implied though not plainly expressed. + + relatedTag + Explicit + + + + Invalid + Not allowed or not conforming to the correct format or specifications. + + relatedTag + Valid + + + + None + No person or thing, nobody, not any. + + relatedTag + All + Some + + + + Some + At least a small amount or number of, but not a large amount of, or often. + + relatedTag + All + None + + + + True + Conforming to facts, reality or definitive criteria. + + relatedTag + False + + + + Valid + Allowable, usable, or acceptable. + + relatedTag + Invalid + + + + Wrong + Inaccurate or not correct. + + relatedTag + Correct + + + + + Categorical-judgment-value + Categorical values that are based on the judgment or perception of the participant such familiar and famous. + + Abnormal + Deviating in any way from the state, position, structure, condition, behavior, or rule which is considered a norm. + + relatedTag + Normal + + + + Asymmetrical + Lacking symmetry or having parts that fail to correspond to one another in shape, size, or arrangement. + + relatedTag + Symmetrical + + + + Audible + A sound that can be perceived by the participant. + + relatedTag + Inaudible + + + + Complex + Hard, involved or complicated, elaborate, having many parts. + + relatedTag + Simple + + + + Congruent + Concordance of multiple evidence lines. In agreement or harmony. + + relatedTag + Incongruent + + + + Constrained + Keeping something within particular limits or bounds. + + relatedTag + Unconstrained + + + + Disordered + Not neatly arranged. Confused and untidy. A structural quality in which the parts of an object are non-rigid. + + relatedTag + Ordered + + + + Familiar + Recognized, familiar, or within the scope of knowledge. + + relatedTag + Unfamiliar + Famous + + + + Famous + A person who has a high degree of recognition by the general population for his or her success or accomplishments. A famous person. + + relatedTag + Familiar + Unfamiliar + + + + Inaudible + A sound below the threshold of perception of the participant. + + relatedTag + Audible + + + + Incongruent + Not in agreement or harmony. + + relatedTag + Congruent + + + + Involuntary + An action that is not made by choice. In the body, involuntary actions (such as blushing) occur automatically, and cannot be controlled by choice. + + relatedTag + Voluntary + + + + Masked + Information exists but is not provided or is partially obscured due to security, privacy, or other concerns. + + relatedTag + Unmasked + + + + Normal + Being approximately average or within certain limits. Conforming with or constituting a norm or standard or level or type or social norm. + + relatedTag + Abnormal + + + + Ordered + Conforming to a logical or comprehensible arrangement of separate elements. + + relatedTag + Disordered + + + + Simple + Easily understood or presenting no difficulties. + + relatedTag + Complex + + + + Symmetrical + Made up of exactly similar parts facing each other or around an axis. Showing aspects of symmetry. + + relatedTag + Asymmetrical + + + + Unconstrained + Moving without restriction. + + relatedTag + Constrained + + + + Unfamiliar + Not having knowledge or experience of. + + relatedTag + Familiar + Famous + + + + Unmasked + Information is revealed. + + relatedTag + Masked + + + + Voluntary + Using free will or design; not forced or compelled; controlled by individual volition. + + relatedTag + Involuntary + + + + + Categorical-level-value + Categorical values based on dividing a continuous variable into levels such as high and low. + + Cold + Having an absence of heat. + + relatedTag + Hot + + + + Deep + Extending relatively far inward or downward. + + relatedTag + Shallow + + + + High + Having a greater than normal degree, intensity, or amount. + + relatedTag + Low + Medium + + + + Hot + Having an excess of heat. + + relatedTag + Cold + + + + Large + Having a great extent such as in physical dimensions, period of time, amplitude or frequency. + + relatedTag + Small + + + + Liminal + Situated at a sensory threshold that is barely perceptible or capable of eliciting a response. + + relatedTag + Subliminal + Supraliminal + + + + Loud + Having a perceived high intensity of sound. + + relatedTag + Quiet + + + + Low + Less than normal in degree, intensity or amount. + + relatedTag + High + + + + Medium + Mid-way between small and large in number, quantity, magnitude or extent. + + relatedTag + Low + High + + + + Negative + Involving disadvantage or harm. + + relatedTag + Positive + + + + Positive + Involving advantage or good. + + relatedTag + Negative + + + + Quiet + Characterizing a perceived low intensity of sound. + + relatedTag + Loud + + + + Rough + Having a surface with perceptible bumps, ridges, or irregularities. + + relatedTag + Smooth + + + + Shallow + Having a depth which is relatively low. + + relatedTag + Deep + + + + Small + Having a small extent such as in physical dimensions, period of time, amplitude or frequency. + + relatedTag + Large + + + + Smooth + Having a surface free from bumps, ridges, or irregularities. + + relatedTag + Rough + + + + Subliminal + Situated below a sensory threshold that is imperceptible or not capable of eliciting a response. + + relatedTag + Liminal + Supraliminal + + + + Supraliminal + Situated above a sensory threshold that is perceptible or capable of eliciting a response. + + relatedTag + Liminal + Subliminal + + + + Thick + Wide in width, extent or cross-section. + + relatedTag + Thin + + + + Thin + Narrow in width, extent or cross-section. + + relatedTag + Thick + + + + + Categorical-orientation-value + Value indicating the orientation or direction of something. + + Backward + Directed behind or to the rear. + + relatedTag + Forward + + + + Downward + Moving or leading toward a lower place or level. + + relatedTag + Leftward + Rightward + Upward + + + + Forward + At or near or directed toward the front. + + relatedTag + Backward + + + + Horizontally-oriented + Oriented parallel to or in the plane of the horizon. + + relatedTag + Vertically-oriented + + + + Leftward + Going toward or facing the left. + + relatedTag + Downward + Rightward + Upward + + + + Oblique + Slanting or inclined in direction, course, or position that is neither parallel nor perpendicular nor right-angular. + + relatedTag + Rotated + + + + Rightward + Going toward or situated on the right. + + relatedTag + Downward + Leftward + Upward + + + + Rotated + Positioned offset around an axis or center. + + + Upward + Moving, pointing, or leading to a higher place, point, or level. + + relatedTag + Downward + Leftward + Rightward + + + + Vertically-oriented + Oriented perpendicular to the plane of the horizon. + + relatedTag + Horizontally-oriented + + + + + + Physical-value + The value of some physical property of something. + + Temperature + A measure of hot or cold based on the average kinetic energy of the atoms or molecules in the system. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + temperatureUnits + + + + + Weight + The relative mass or the quantity of matter contained by something. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + weightUnits + + + + + + Quantitative-value + Something capable of being estimated or expressed with numeric values. + + Fraction + A numerical value between 0 and 1. + + # + + takesValue + + + valueClass + numericClass + + + + + Item-count + The integer count of something which is usually grouped with the entity it is counting. (Item-count/3, A) indicates that 3 of A have occurred up to this point. + + # + + takesValue + + + valueClass + numericClass + + + + + Item-index + The index of an item in a collection, sequence or other structure. (A (Item-index/3, B)) means that A is item number 3 in B. + + # + + takesValue + + + valueClass + numericClass + + + + + Item-interval + An integer indicating how many items or entities have passed since the last one of these. An item interval of 0 indicates the current item. + + # + + takesValue + + + valueClass + numericClass + + + + + Percentage + A fraction or ratio with 100 understood as the denominator. + + # + + takesValue + + + valueClass + numericClass + + + + + Ratio + A quotient of quantities of the same kind for different components within the same system. + + # + + takesValue + + + valueClass + numericClass + + + + + + Spatiotemporal-value + A property relating to space and/or time. + + Rate-of-change + The amount of change accumulated per unit time. + + Acceleration + Magnitude of the rate of change in either speed or direction. The direction of change should be given separately. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + accelerationUnits + + + + + Frequency + Frequency is the number of occurrences of a repeating event per unit time. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + frequencyUnits + + + + + Jerk-rate + Magnitude of the rate at which the acceleration of an object changes with respect to time. The direction of change should be given separately. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + jerkUnits + + + + + Refresh-rate + The frequency with which the image on a computer monitor or similar electronic display screen is refreshed, usually expressed in hertz. + + # + + takesValue + + + valueClass + numericClass + + + + + Sampling-rate + The number of digital samples taken or recorded per unit of time. + + # + + takesValue + + + unitClass + frequencyUnits + + + + + Speed + A scalar measure of the rate of movement of the object expressed either as the distance travelled divided by the time taken (average speed) or the rate of change of position with respect to time at a particular point (instantaneous speed). The direction of change should be given separately. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + speedUnits + + + + + Temporal-rate + The number of items per unit of time. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + frequencyUnits + + + + + + Spatial-value + Value of an item involving space. + + Angle + The amount of inclination of one line to another or the plane of one object to another. + + # + + takesValue + + + unitClass + angleUnits + + + valueClass + numericClass + + + + + Distance + A measure of the space separating two objects or points. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + physicalLengthUnits + + + + + Position + A reference to the alignment of an object, a particular situation or view of a situation, or the location of an object. Coordinates with respect a specified frame of reference or the default Screen-frame if no frame is given. + + X-position + The position along the x-axis of the frame of reference. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + physicalLengthUnits + + + + + Y-position + The position along the y-axis of the frame of reference. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + physicalLengthUnits + + + + + Z-position + The position along the z-axis of the frame of reference. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + physicalLengthUnits + + + + + + Size + The physical magnitude of something. + + Area + The extent of a 2-dimensional surface enclosed within a boundary. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + areaUnits + + + + + Depth + The distance from the surface of something especially from the perspective of looking from the front. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + physicalLengthUnits + + + + + Height + The vertical measurement or distance from the base to the top of an object. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + physicalLengthUnits + + + + + Length + The linear extent in space from one end of something to the other end, or the extent of something from beginning to end. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + physicalLengthUnits + + + + + Volume + The amount of three dimensional space occupied by an object or the capacity of a space or container. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + volumeUnits + + + + + Width + The extent or measurement of something from side to side. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + physicalLengthUnits + + + + + + + Temporal-value + A characteristic of or relating to time or limited by time. + + Delay + The time at which an event start time is delayed from the current onset time. This tag defines the start time of an event of temporal extent and may be used with the Duration tag. + + topLevelTagGroup + + + reserved + + + relatedTag + Duration + + + # + + takesValue + + + valueClass + numericClass + + + unitClass + timeUnits + + + + + Duration + The period of time during which an event occurs. This tag defines the end time of an event of temporal extent and may be used with the Delay tag. + + topLevelTagGroup + + + reserved + + + relatedTag + Delay + + + # + + takesValue + + + valueClass + numericClass + + + unitClass + timeUnits + + + + + Time-interval + The period of time separating two instances, events, or occurrences. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + timeUnits + + + + + Time-value + A value with units of time. Usually grouped with tags identifying what the value represents. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + timeUnits + + + + + + + Statistical-value + A value based on or employing the principles of statistics. + + extensionAllowed + + + Data-maximum + The largest possible quantity or degree. + + # + + takesValue + + + valueClass + numericClass + + + + + Data-mean + The sum of a set of values divided by the number of values in the set. + + # + + takesValue + + + valueClass + numericClass + + + + + Data-median + The value which has an equal number of values greater and less than it. + + # + + takesValue + + + valueClass + numericClass + + + + + Data-minimum + The smallest possible quantity. + + # + + takesValue + + + valueClass + numericClass + + + + + Probability + A measure of the expectation of the occurrence of a particular event. + + # + + takesValue + + + valueClass + numericClass + + + + + Standard-deviation + A measure of the range of values in a set of numbers. Standard deviation is a statistic used as a measure of the dispersion or variation in a distribution, equal to the square root of the arithmetic mean of the squares of the deviations from the arithmetic mean. + + # + + takesValue + + + valueClass + numericClass + + + + + Statistical-accuracy + A measure of closeness to true value expressed as a number between 0 and 1. + + # + + takesValue + + + valueClass + numericClass + + + + + Statistical-precision + A quantitative representation of the degree of accuracy necessary for or associated with a particular action. + + # + + takesValue + + + valueClass + numericClass + + + + + Statistical-recall + Sensitivity is a measurement datum qualifying a binary classification test and is computed by substracting the false negative rate to the integral numeral 1. + + # + + takesValue + + + valueClass + numericClass + + + + + Statistical-uncertainty + A measure of the inherent variability of repeated observation measurements of a quantity including quantities evaluated by statistical methods and by other means. + + # + + takesValue + + + valueClass + numericClass + + + + + + + Data-variability-attribute + An attribute describing how something changes or varies. + + Abrupt + Marked by sudden change. + + + Constant + Continually recurring or continuing without interruption. Not changing in time or space. + + + Continuous + Uninterrupted in time, sequence, substance, or extent. + + relatedTag + Discrete + Discontinuous + + + + Decreasing + Becoming smaller or fewer in size, amount, intensity, or degree. + + relatedTag + Increasing + + + + Deterministic + No randomness is involved in the development of the future states of the element. + + relatedTag + Random + Stochastic + + + + Discontinuous + Having a gap in time, sequence, substance, or extent. + + relatedTag + Continuous + + + + Discrete + Constituting a separate entities or parts. + + relatedTag + Continuous + Discontinuous + + + + Estimated-value + Something that has been calculated or measured approximately. + + + Exact-value + A value that is viewed to the true value according to some standard. + + + Flickering + Moving irregularly or unsteadily or burning or shining fitfully or with a fluctuating light. + + + Fractal + Having extremely irregular curves or shapes for which any suitably chosen part is similar in shape to a given larger or smaller part when magnified or reduced to the same size. + + + Increasing + Becoming greater in size, amount, or degree. + + relatedTag + Decreasing + + + + Random + Governed by or depending on chance. Lacking any definite plan or order or purpose. + + relatedTag + Deterministic + Stochastic + + + + Repetitive + A recurring action that is often non-purposeful. + + + Stochastic + Uses a random probability distribution or pattern that may be analysed statistically but may not be predicted precisely to determine future states. + + relatedTag + Deterministic + Random + + + + Varying + Differing in size, amount, degree, or nature. + + + + + Environmental-property + Relating to or arising from the surroundings of an agent. + + Augmented-reality + Using technology that enhances real-world experiences with computer-derived digital overlays to change some aspects of perception of the natural environment. The digital content is shown to the user through a smart device or glasses and responds to changes in the environment. + + + Indoors + Located inside a building or enclosure. + + + Motion-platform + A mechanism that creates the feelings of being in a real motion environment. + + + Outdoors + Any area outside a building or shelter. + + + Real-world + Located in a place that exists in real space and time under realistic conditions. + + + Rural + Of or pertaining to the country as opposed to the city. + + + Terrain + Characterization of the physical features of a tract of land. + + Composite-terrain + Tracts of land characterized by a mixure of physical features. + + + Dirt-terrain + Tracts of land characterized by a soil surface and lack of vegetation. + + + Grassy-terrain + Tracts of land covered by grass. + + + Gravel-terrain + Tracts of land covered by a surface consisting a loose aggregation of small water-worn or pounded stones. + + + Leaf-covered-terrain + Tracts of land covered by leaves and composited organic material. + + + Muddy-terrain + Tracts of land covered by a liquid or semi-liquid mixture of water and some combination of soil, silt, and clay. + + + Paved-terrain + Tracts of land covered with concrete, asphalt, stones, or bricks. + + + Rocky-terrain + Tracts of land consisting or full of rock or rocks. + + + Sloped-terrain + Tracts of land arranged in a sloping or inclined position. + + + Uneven-terrain + Tracts of land that are not level, smooth, or regular. + + + + Urban + Relating to, located in, or characteristic of a city or densely populated area. + + + Virtual-world + Using technology that creates immersive, computer-generated experiences that a person can interact with and navigate through. The digital content is generally delivered to the user through some type of headset and responds to changes in head position or through interaction with other types of sensors. Existing in a virtual setting such as a simulation or game environment. + + + + Informational-property + Something that pertains to a task. + + extensionAllowed + + + Description + An explanation of what the tag group it is in means. If the description is at the top-level of an event string, the description applies to the event. + + requireChild + + + # + + takesValue + + + valueClass + textClass + + + + + ID + An alphanumeric name that identifies either a unique object or a unique class of objects. Here the object or class may be an idea, physical countable object (or class), or physical uncountable substance (or class). + + requireChild + + + # + + takesValue + + + valueClass + textClass + + + + + Label + A string of 20 or fewer characters identifying something. Labels usually refer to general classes of things while IDs refer to specific instances. A term that is associated with some entity. A brief description given for purposes of identification. An identifying or descriptive marker that is attached to an object. + + requireChild + + + # + + takesValue + + + valueClass + nameClass + + + + + Metadata + Data about data. Information that describes another set of data. + + CogAtlas + The Cognitive Atlas ID number of something. + + # + + takesValue + + + + + CogPo + The CogPO ID number of something. + + # + + takesValue + + + + + Creation-date + The date on which data creation of this element began. + + requireChild + + + # + + takesValue + + + valueClass + dateTimeClass + + + + + Experimental-note + A brief written record about the experiment. + + # + + takesValue + + + valueClass + textClass + + + + + Library-name + Official name of a HED library. + + # + + takesValue + + + valueClass + nameClass + + + + + OBO-identifier + The identifier of a term in some Open Biology Ontology (OBO) ontology. + + # + + takesValue + + + valueClass + nameClass + + + + + Pathname + The specification of a node (file or directory) in a hierarchical file system, usually specified by listing the nodes top-down. + + # + + takesValue + + + + + Subject-identifier + A sequence of characters used to identify, name, or characterize a trial or study subject. + + # + + takesValue + + + + + Version-identifier + An alphanumeric character string that identifies a form or variant of a type or original. + + # + Usually is a semantic version. + + takesValue + + + + + + Parameter + Something user-defined for this experiment. + + Parameter-label + The name of the parameter. + + # + + takesValue + + + valueClass + nameClass + + + + + Parameter-value + The value of the parameter. + + # + + takesValue + + + valueClass + textClass + + + + + + + Organizational-property + Relating to an organization or the action of organizing something. + + Collection + A tag designating a grouping of items such as in a set or list. + + # + Name of the collection. + + takesValue + + + valueClass + nameClass + + + + + Condition-variable + An aspect of the experiment or task that is to be varied during the experiment. Task-conditions are sometimes called independent variables or contrasts. + + # + Name of the condition variable. + + takesValue + + + valueClass + nameClass + + + + + Control-variable + An aspect of the experiment that is fixed throughout the study and usually is explicitly controlled. + + # + Name of the control variable. + + takesValue + + + valueClass + nameClass + + + + + Def + A HED-specific utility tag used with a defined name to represent the tags associated with that definition. + + requireChild + + + reserved + + + # + Name of the definition. + + takesValue + + + valueClass + nameClass + + + + + Def-expand + A HED specific utility tag that is grouped with an expanded definition. The child value of the Def-expand is the name of the expanded definition. + + requireChild + + + reserved + + + tagGroup + + + # + + takesValue + + + valueClass + nameClass + + + + + Definition + A HED-specific utility tag whose child value is the name of the concept and the tag group associated with the tag is an English language explanation of a concept. + + requireChild + + + reserved + + + topLevelTagGroup + + + # + Name of the definition. + + takesValue + + + valueClass + nameClass + + + + + Event-context + A special HED tag inserted as part of a top-level tag group to contain information about the interrelated conditions under which the event occurs. The event context includes information about other events that are ongoing when this event happens. + + reserved + + + topLevelTagGroup + + + unique + + + + Event-stream + A special HED tag indicating that this event is a member of an ordered succession of events. + + # + Name of the event stream. + + takesValue + + + valueClass + nameClass + + + + + Experimental-intertrial + A tag used to indicate a part of the experiment between trials usually where nothing is happening. + + # + Optional label for the intertrial block. + + takesValue + + + valueClass + nameClass + + + + + Experimental-trial + Designates a run or execution of an activity, for example, one execution of a script. A tag used to indicate a particular organizational part in the experimental design often containing a stimulus-response pair or stimulus-response-feedback triad. + + # + Optional label for the trial (often a numerical string). + + takesValue + + + valueClass + nameClass + + + + + Indicator-variable + An aspect of the experiment or task that is measured as task conditions are varied during the experiment. Experiment indicators are sometimes called dependent variables. + + # + Name of the indicator variable. + + takesValue + + + valueClass + nameClass + + + + + Recording + A tag designating the data recording. Recording tags are usually have temporal scope which is the entire recording. + + # + Optional label for the recording. + + takesValue + + + valueClass + nameClass + + + + + Task + An assigned piece of work, usually with a time allotment. A tag used to indicate a linkage the structured activities performed as part of the experiment. + + # + Optional label for the task block. + + takesValue + + + valueClass + nameClass + + + + + Time-block + A tag used to indicate a contiguous time block in the experiment during which something is fixed or noted. + + # + Optional label for the task block. + + takesValue + + + valueClass + nameClass + + + + + + Sensory-property + Relating to sensation or the physical senses. + + Sensory-attribute + A sensory characteristic associated with another entity. + + Auditory-attribute + Pertaining to the sense of hearing. + + Loudness + Perceived intensity of a sound. + + # + + takesValue + + + valueClass + numericClass + nameClass + + + + + Pitch + A perceptual property that allows the user to order sounds on a frequency scale. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + frequencyUnits + + + + + Sound-envelope + Description of how a sound changes over time. + + Sound-envelope-attack + The time taken for initial run-up of level from nil to peak usually beginning when the key on a musical instrument is pressed. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + timeUnits + + + + + Sound-envelope-decay + The time taken for the subsequent run down from the attack level to the designated sustain level. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + timeUnits + + + + + Sound-envelope-release + The time taken for the level to decay from the sustain level to zero after the key is released. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + timeUnits + + + + + Sound-envelope-sustain + The time taken for the main sequence of the sound duration, until the key is released. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + timeUnits + + + + + + Sound-volume + The sound pressure level (SPL) usually the ratio to a reference signal estimated as the lower bound of hearing. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + intensityUnits + + + + + Timbre + The perceived sound quality of a singing voice or musical instrument. + + # + + takesValue + + + valueClass + nameClass + + + + + + Gustatory-attribute + Pertaining to the sense of taste. + + Bitter + Having a sharp, pungent taste. + + + Salty + Tasting of or like salt. + + + Savory + Belonging to a taste that is salty or spicy rather than sweet. + + + Sour + Having a sharp, acidic taste. + + + Sweet + Having or resembling the taste of sugar. + + + + Olfactory-attribute + Having a smell. + + + Somatic-attribute + Pertaining to the feelings in the body or of the nervous system. + + Pain + The sensation of discomfort, distress, or agony, resulting from the stimulation of specialized nerve endings. + + + Stress + The negative mental, emotional, and physical reactions that occur when environmental stressors are perceived as exceeding the adaptive capacities of the individual. + + + + Tactile-attribute + Pertaining to the sense of touch. + + Tactile-pressure + Having a feeling of heaviness. + + + Tactile-temperature + Having a feeling of hotness or coldness. + + + Tactile-texture + Having a feeling of roughness. + + + Tactile-vibration + Having a feeling of mechanical oscillation. + + + + Vestibular-attribute + Pertaining to the sense of balance or body position. + + + Visual-attribute + Pertaining to the sense of sight. + + Color + The appearance of objects (or light sources) described in terms of perception of their hue and lightness (or brightness) and saturation. + + CSS-color + One of 140 colors supported by all browsers. For more details such as the color RGB or HEX values, check: https://www.w3schools.com/colors/colors_groups.asp. + + Blue-color + CSS color group. + + Blue + CSS-color 0x0000FF. + + + CadetBlue + CSS-color 0x5F9EA0. + + + CornflowerBlue + CSS-color 0x6495ED. + + + DarkBlue + CSS-color 0x00008B. + + + DeepSkyBlue + CSS-color 0x00BFFF. + + + DodgerBlue + CSS-color 0x1E90FF. + + + LightBlue + CSS-color 0xADD8E6. + + + LightSkyBlue + CSS-color 0x87CEFA. + + + LightSteelBlue + CSS-color 0xB0C4DE. + + + MediumBlue + CSS-color 0x0000CD. + + + MidnightBlue + CSS-color 0x191970. + + + Navy + CSS-color 0x000080. + + + PowderBlue + CSS-color 0xB0E0E6. + + + RoyalBlue + CSS-color 0x4169E1. + + + SkyBlue + CSS-color 0x87CEEB. + + + SteelBlue + CSS-color 0x4682B4. + + + + Brown-color + CSS color group. + + Bisque + CSS-color 0xFFE4C4. + + + BlanchedAlmond + CSS-color 0xFFEBCD. + + + Brown + CSS-color 0xA52A2A. + + + BurlyWood + CSS-color 0xDEB887. + + + Chocolate + CSS-color 0xD2691E. + + + Cornsilk + CSS-color 0xFFF8DC. + + + DarkGoldenRod + CSS-color 0xB8860B. + + + GoldenRod + CSS-color 0xDAA520. + + + Maroon + CSS-color 0x800000. + + + NavajoWhite + CSS-color 0xFFDEAD. + + + Olive + CSS-color 0x808000. + + + Peru + CSS-color 0xCD853F. + + + RosyBrown + CSS-color 0xBC8F8F. + + + SaddleBrown + CSS-color 0x8B4513. + + + SandyBrown + CSS-color 0xF4A460. + + + Sienna + CSS-color 0xA0522D. + + + Tan + CSS-color 0xD2B48C. + + + Wheat + CSS-color 0xF5DEB3. + + + + Cyan-color + CSS color group. + + Aqua + CSS-color 0x00FFFF. + + + Aquamarine + CSS-color 0x7FFFD4. + + + Cyan + CSS-color 0x00FFFF. + + + DarkTurquoise + CSS-color 0x00CED1. + + + LightCyan + CSS-color 0xE0FFFF. + + + MediumTurquoise + CSS-color 0x48D1CC. + + + PaleTurquoise + CSS-color 0xAFEEEE. + + + Turquoise + CSS-color 0x40E0D0. + + + + Gray-color + CSS color group. + + Black + CSS-color 0x000000. + + + DarkGray + CSS-color 0xA9A9A9. + + + DarkSlateGray + CSS-color 0x2F4F4F. + + + DimGray + CSS-color 0x696969. + + + Gainsboro + CSS-color 0xDCDCDC. + + + Gray + CSS-color 0x808080. + + + LightGray + CSS-color 0xD3D3D3. + + + LightSlateGray + CSS-color 0x778899. + + + Silver + CSS-color 0xC0C0C0. + + + SlateGray + CSS-color 0x708090. + + + + Green-color + CSS color group. + + Chartreuse + CSS-color 0x7FFF00. + + + DarkCyan + CSS-color 0x008B8B. + + + DarkGreen + CSS-color 0x006400. + + + DarkOliveGreen + CSS-color 0x556B2F. + + + DarkSeaGreen + CSS-color 0x8FBC8F. + + + ForestGreen + CSS-color 0x228B22. + + + Green + CSS-color 0x008000. + + + GreenYellow + CSS-color 0xADFF2F. + + + LawnGreen + CSS-color 0x7CFC00. + + + LightGreen + CSS-color 0x90EE90. + + + LightSeaGreen + CSS-color 0x20B2AA. + + + Lime + CSS-color 0x00FF00. + + + LimeGreen + CSS-color 0x32CD32. + + + MediumAquaMarine + CSS-color 0x66CDAA. + + + MediumSeaGreen + CSS-color 0x3CB371. + + + MediumSpringGreen + CSS-color 0x00FA9A. + + + OliveDrab + CSS-color 0x6B8E23. + + + PaleGreen + CSS-color 0x98FB98. + + + SeaGreen + CSS-color 0x2E8B57. + + + SpringGreen + CSS-color 0x00FF7F. + + + Teal + CSS-color 0x008080. + + + YellowGreen + CSS-color 0x9ACD32. + + + + Orange-color + CSS color group. + + Coral + CSS-color 0xFF7F50. + + + DarkOrange + CSS-color 0xFF8C00. + + + Orange + CSS-color 0xFFA500. + + + OrangeRed + CSS-color 0xFF4500. + + + Tomato + CSS-color 0xFF6347. + + + + Pink-color + CSS color group. + + DeepPink + CSS-color 0xFF1493. + + + HotPink + CSS-color 0xFF69B4. + + + LightPink + CSS-color 0xFFB6C1. + + + MediumVioletRed + CSS-color 0xC71585. + + + PaleVioletRed + CSS-color 0xDB7093. + + + Pink + CSS-color 0xFFC0CB. + + + + Purple-color + CSS color group. + + BlueViolet + CSS-color 0x8A2BE2. + + + DarkMagenta + CSS-color 0x8B008B. + + + DarkOrchid + CSS-color 0x9932CC. + + + DarkSlateBlue + CSS-color 0x483D8B. + + + DarkViolet + CSS-color 0x9400D3. + + + Fuchsia + CSS-color 0xFF00FF. + + + Indigo + CSS-color 0x4B0082. + + + Lavender + CSS-color 0xE6E6FA. + + + Magenta + CSS-color 0xFF00FF. + + + MediumOrchid + CSS-color 0xBA55D3. + + + MediumPurple + CSS-color 0x9370DB. + + + MediumSlateBlue + CSS-color 0x7B68EE. + + + Orchid + CSS-color 0xDA70D6. + + + Plum + CSS-color 0xDDA0DD. + + + Purple + CSS-color 0x800080. + + + RebeccaPurple + CSS-color 0x663399. + + + SlateBlue + CSS-color 0x6A5ACD. + + + Thistle + CSS-color 0xD8BFD8. + + + Violet + CSS-color 0xEE82EE. + + + + Red-color + CSS color group. + + Crimson + CSS-color 0xDC143C. + + + DarkRed + CSS-color 0x8B0000. + + + DarkSalmon + CSS-color 0xE9967A. + + + FireBrick + CSS-color 0xB22222. + + + IndianRed + CSS-color 0xCD5C5C. + + + LightCoral + CSS-color 0xF08080. + + + LightSalmon + CSS-color 0xFFA07A. + + + Red + CSS-color 0xFF0000. + + + Salmon + CSS-color 0xFA8072. + + + + White-color + CSS color group. + + AliceBlue + CSS-color 0xF0F8FF. + + + AntiqueWhite + CSS-color 0xFAEBD7. + + + Azure + CSS-color 0xF0FFFF. + + + Beige + CSS-color 0xF5F5DC. + + + FloralWhite + CSS-color 0xFFFAF0. + + + GhostWhite + CSS-color 0xF8F8FF. + + + HoneyDew + CSS-color 0xF0FFF0. + + + Ivory + CSS-color 0xFFFFF0. + + + LavenderBlush + CSS-color 0xFFF0F5. + + + Linen + CSS-color 0xFAF0E6. + + + MintCream + CSS-color 0xF5FFFA. + + + MistyRose + CSS-color 0xFFE4E1. + + + OldLace + CSS-color 0xFDF5E6. + + + SeaShell + CSS-color 0xFFF5EE. + + + Snow + CSS-color 0xFFFAFA. + + + White + CSS-color 0xFFFFFF. + + + WhiteSmoke + CSS-color 0xF5F5F5. + + + + Yellow-color + CSS color group. + + DarkKhaki + CSS-color 0xBDB76B. + + + Gold + CSS-color 0xFFD700. + + + Khaki + CSS-color 0xF0E68C. + + + LemonChiffon + CSS-color 0xFFFACD. + + + LightGoldenRodYellow + CSS-color 0xFAFAD2. + + + LightYellow + CSS-color 0xFFFFE0. + + + Moccasin + CSS-color 0xFFE4B5. + + + PaleGoldenRod + CSS-color 0xEEE8AA. + + + PapayaWhip + CSS-color 0xFFEFD5. + + + PeachPuff + CSS-color 0xFFDAB9. + + + Yellow + CSS-color 0xFFFF00. + + + + + Color-shade + A slight degree of difference between colors, especially with regard to how light or dark it is or as distinguished from one nearly like it. + + Dark-shade + A color tone not reflecting much light. + + + Light-shade + A color tone reflecting more light. + + + + Grayscale + Using a color map composed of shades of gray, varying from black at the weakest intensity to white at the strongest. + + # + White intensity between 0 and 1. + + takesValue + + + valueClass + numericClass + + + + + HSV-color + A color representation that models how colors appear under light. + + HSV-value + An attribute of a visual sensation according to which an area appears to emit more or less light. + + # + + takesValue + + + valueClass + numericClass + + + + + Hue + Attribute of a visual sensation according to which an area appears to be similar to one of the perceived colors. + + # + Angular value between 0 and 360. + + takesValue + + + valueClass + numericClass + + + + + Saturation + Colorfulness of a stimulus relative to its own brightness. + + # + B value of RGB between 0 and 1. + + takesValue + + + valueClass + numericClass + + + + + + RGB-color + A color from the RGB schema. + + RGB-blue + The blue component. + + # + B value of RGB between 0 and 1. + + takesValue + + + valueClass + numericClass + + + + + RGB-green + The green component. + + # + G value of RGB between 0 and 1. + + takesValue + + + valueClass + numericClass + + + + + RGB-red + The red component. + + # + R value of RGB between 0 and 1. + + takesValue + + + valueClass + numericClass + + + + + + + Luminance + A quality that exists by virtue of the luminous intensity per unit area projected in a given direction. + + + Opacity + A measure of impenetrability to light. + + + + + Sensory-presentation + The entity has a sensory manifestation. + + Auditory-presentation + The sense of hearing is used in the presentation to the user. + + Loudspeaker-separation + The distance between two loudspeakers. Grouped with the Distance tag. + + suggestedTag + Distance + + + + Monophonic + Relating to sound transmission, recording, or reproduction involving a single transmission path. + + + Silent + The absence of ambient audible sound or the state of having ceased to produce sounds. + + + Stereophonic + Relating to, or constituting sound reproduction involving the use of separated microphones and two transmission channels to achieve the sound separation of a live hearing. + + + + Gustatory-presentation + The sense of taste used in the presentation to the user. + + + Olfactory-presentation + The sense of smell used in the presentation to the user. + + + Somatic-presentation + The nervous system is used in the presentation to the user. + + + Tactile-presentation + The sense of touch used in the presentation to the user. + + + Vestibular-presentation + The sense balance used in the presentation to the user. + + + Visual-presentation + The sense of sight used in the presentation to the user. + + 2D-view + A view showing only two dimensions. + + + 3D-view + A view showing three dimensions. + + + Background-view + Parts of the view that are farthest from the viewer and usually the not part of the visual focus. + + + Bistable-view + Something having two stable visual forms that have two distinguishable stable forms as in optical illusions. + + + Foreground-view + Parts of the view that are closest to the viewer and usually the most important part of the visual focus. + + + Foveal-view + Visual presentation directly on the fovea. A view projected on the small depression in the retina containing only cones and where vision is most acute. + + + Map-view + A diagrammatic representation of an area of land or sea showing physical features, cities, roads. + + Aerial-view + Elevated view of an object from above, with a perspective as though the observer were a bird. + + + Satellite-view + A representation as captured by technology such as a satellite. + + + Street-view + A 360-degrees panoramic view from a position on the ground. + + + + Peripheral-view + Indirect vision as it occurs outside the point of fixation. + + + + + + Task-property + Something that pertains to a task. + + extensionAllowed + + + Task-action-type + How an agent action should be interpreted in terms of the task specification. + + Appropriate-action + An action suitable or proper in the circumstances. + + relatedTag + Inappropriate-action + + + + Correct-action + An action that was a correct response in the context of the task. + + relatedTag + Incorrect-action + Indeterminate-action + + + + Correction + An action offering an improvement to replace a mistake or error. + + + Done-indication + An action that indicates that the participant has completed this step in the task. + + relatedTag + Ready-indication + + + + Imagined-action + Form a mental image or concept of something. This is used to identity something that only happened in the imagination of the participant as in imagined movements in motor imagery paradigms. + + + Inappropriate-action + An action not in keeping with what is correct or proper for the task. + + relatedTag + Appropriate-action + + + + Incorrect-action + An action considered wrong or incorrect in the context of the task. + + relatedTag + Correct-action + Indeterminate-action + + + + Indeterminate-action + An action that cannot be distinguished between two or more possibibities in the current context. This tag might be applied when an outside evaluator or a classification algorithm cannot determine a definitive result. + + relatedTag + Correct-action + Incorrect-action + Miss + Near-miss + + + + Miss + An action considered to be a failure in the context of the task. For example, if the agent is supposed to try to hit a target and misses. + + relatedTag + Near-miss + + + + Near-miss + An action barely satisfied the requirements of the task. In a driving experiment for example this could pertain to a narrowly avoided collision or other accident. + + relatedTag + Miss + + + + Omitted-action + An expected response was skipped. + + + Ready-indication + An action that indicates that the participant is ready to perform the next step in the task. + + relatedTag + Done-indication + + + + + Task-attentional-demand + Strategy for allocating attention toward goal-relevant information. + + Bottom-up-attention + Attentional guidance purely by externally driven factors to stimuli that are salient because of their inherent properties relative to the background. Sometimes this is referred to as stimulus driven. + + relatedTag + Top-down-attention + + + + Covert-attention + Paying attention without moving the eyes. + + relatedTag + Overt-attention + + + + Divided-attention + Integrating parallel multiple stimuli. Behavior involving responding simultaneously to multiple tasks or multiple task demands. + + relatedTag + Focused-attention + + + + Focused-attention + Responding discretely to specific visual, auditory, or tactile stimuli. + + relatedTag + Divided-attention + + + + Orienting-attention + Directing attention to a target stimulus. + + + Overt-attention + Selectively processing one location over others by moving the eyes to point at that location. + + relatedTag + Covert-attention + + + + Selective-attention + Maintaining a behavioral or cognitive set in the face of distracting or competing stimuli. Ability to pay attention to a limited array of all available sensory information. + + + Sustained-attention + Maintaining a consistent behavioral response during continuous and repetitive activity. + + + Switched-attention + Having to switch attention between two or more modalities of presentation. + + + Top-down-attention + Voluntary allocation of attention to certain features. Sometimes this is referred to goal-oriented attention. + + relatedTag + Bottom-up-attention + + + + + Task-effect-evidence + The evidence supporting the conclusion that the event had the specified effect. + + Behavioral-evidence + An indication or conclusion based on the behavior of an agent. + + + Computational-evidence + A type of evidence in which data are produced, and/or generated, and/or analyzed on a computer. + + + External-evidence + A phenomenon that follows and is caused by some previous phenomenon. + + + Intended-effect + A phenomenon that is intended to follow and be caused by some previous phenomenon. + + + + Task-event-role + The purpose of an event with respect to the task. + + Experimental-stimulus + Part of something designed to elicit a response in the experiment. + + + Incidental + A sensory or other type of event that is unrelated to the task or experiment. + + + Instructional + Usually associated with a sensory event intended to give instructions to the participant about the task or behavior. + + + Mishap + Unplanned disruption such as an equipment or experiment control abnormality or experimenter error. + + + Participant-response + Something related to a participant actions in performing the task. + + + Task-activity + Something that is part of the overall task or is necessary to the overall experiment but is not directly part of a stimulus-response cycle. Examples would be taking a survey or provided providing a silva sample. + + + Warning + Something that should warn the participant that the parameters of the task have been or are about to be exceeded such as a warning message about getting too close to the shoulder of the road in a driving task. + + + + Task-relationship + Specifying organizational importance of sub-tasks. + + Background-subtask + A part of the task which should be performed in the background as for example inhibiting blinks due to instruction while performing the primary task. + + + Primary-subtask + A part of the task which should be the primary focus of the participant. + + + + Task-stimulus-role + The role the stimulus plays in the task. + + Cue + A signal for an action, a pattern of stimuli indicating a particular response. + + + Distractor + A person or thing that distracts or a plausible but incorrect option in a multiple-choice question. In pyschological studies this is sometimes referred to as a foil. + + + Expected + Considered likely, probable or anticipated. Something of low information value as in frequent non-targets in an RSVP paradigm. + + relatedTag + Unexpected + + + suggestedTag + Target + + + + Extraneous + Irrelevant or unrelated to the subject being dealt with. + + + Feedback + An evaluative response to an inquiry, process, event, or activity. + + + Go-signal + An indicator to proceed with a planned action. + + relatedTag + Stop-signal + + + + Meaningful + Conveying significant or relevant information. + + + Newly-learned + Representing recently acquired information or understanding. + + + Non-informative + Something that is not useful in forming an opinion or judging an outcome. + + + Non-target + Something other than that done or looked for. Also tag Expected if the Non-target is frequent. + + relatedTag + Target + + + + Not-meaningful + Not having a serious, important, or useful quality or purpose. + + + Novel + Having no previous example or precedent or parallel. + + + Oddball + Something unusual, or infrequent. + + relatedTag + Unexpected + + + suggestedTag + Target + + + + Penalty + A disadvantage, loss, or hardship due to some action. + + + Planned + Something that was decided on or arranged in advance. + + relatedTag + Unplanned + + + + Priming + An implicit memory effect in which exposure to a stimulus influences response to a later stimulus. + + + Query + A sentence of inquiry that asks for a reply. + + + Reward + A positive reinforcement for a desired action, behavior or response. + + + Stop-signal + An indicator that the agent should stop the current activity. + + relatedTag + Go-signal + + + + Target + Something fixed as a goal, destination, or point of examination. + + + Threat + An indicator that signifies hostility and predicts an increased probability of attack. + + + Timed + Something planned or scheduled to be done at a particular time or lasting for a specified amount of time. + + + Unexpected + Something that is not anticipated. + + relatedTag + Expected + + + + Unplanned + Something that has not been planned as part of the task. + + relatedTag + Planned + + + + + + + Relation + Concerns the way in which two or more people or things are connected. + + extensionAllowed + + + Comparative-relation + Something considered in comparison to something else. The first entity is the focus. + + Approximately-equal-to + (A, (Approximately-equal-to, B)) indicates that A and B have almost the same value. Here A and B could refer to sizes, orders, positions or other quantities. + + + Equal-to + (A, (Equal-to, B)) indicates that the size or order of A is the same as that of B. + + + Greater-than + (A, (Greater-than, B)) indicates that the relative size or order of A is bigger than that of B. + + + Greater-than-or-equal-to + (A, (Greater-than-or-equal-to, B)) indicates that the relative size or order of A is bigger than or the same as that of B. + + + Less-than + (A, (Less-than, B)) indicates that A is smaller than B. Here A and B could refer to sizes, orders, positions or other quantities. + + + Less-than-or-equal-to + (A, (Less-than-or-equal-to, B)) indicates that the relative size or order of A is smaller than or equal to B. + + + Not-equal-to + (A, (Not-equal-to, B)) indicates that the size or order of A is not the same as that of B. + + + + Connective-relation + Indicates two entities are related in some way. The first entity is the focus. + + Belongs-to + (A, (Belongs-to, B)) indicates that A is a member of B. + + + Connected-to + (A, (Connected-to, B)) indicates that A is related to B in some respect, usually through a direct link. + + + Contained-in + (A, (Contained-in, B)) indicates that A is completely inside of B. + + + Described-by + (A, (Described-by, B)) indicates that B provides information about A. + + + From-to + (A, (From-to, B)) indicates a directional relation from A to B. A is considered the source. + + + Group-of + (A, (Group-of, B)) indicates A is a group of items of type B. + + + Implied-by + (A, (Implied-by, B)) indicates B is suggested by A. + + + Includes + (A, (Includes, B)) indicates that A has B as a member or part. + + + Interacts-with + (A, (Interacts-with, B)) indicates A and B interact, possibly reciprocally. + + + Member-of + (A, (Member-of, B)) indicates A is a member of group B. + + + Part-of + (A, (Part-of, B)) indicates A is a part of the whole B. + + + Performed-by + (A, (Performed-by, B)) indicates that the action or procedure A was carried out by agent B. + + + Performed-using + (A, (Performed-using, B)) indicates that the action or procedure A was accomplished using B. + + + Related-to + (A, (Related-to, B)) indicates A has some relationship to B. + + + Unrelated-to + (A, (Unrelated-to, B)) indicates that A is not related to B. For example, A is not related to Task. + + + + Directional-relation + A relationship indicating direction of change of one entity relative to another. The first entity is the focus. + + Away-from + (A, (Away-from, B)) indicates that A is going or has moved away from B. The meaning depends on A and B. + + + Towards + (A, (Towards, B)) indicates that A is going to or has moved to B. The meaning depends on A and B. + + + + Logical-relation + Indicating a logical relationship between entities. The first entity is usually the focus. + + And + (A, (And, B)) means A and B are both in effect. + + + Or + (A, (Or, B)) means at least one of A and B are in effect. + + + + Spatial-relation + Indicating a relationship about position between entities. + + Above + (A, (Above, B)) means A is in a place or position that is higher than B. + + + Across-from + (A, (Across-from, B)) means A is on the opposite side of something from B. + + + Adjacent-to + (A, (Adjacent-to, B)) indicates that A is next to B in time or space. + + + Ahead-of + (A, (Ahead-of, B)) indicates that A is further forward in time or space in B. + + + Around + (A, (Around, B)) means A is in or near the present place or situation of B. + + + Behind + (A, (Behind, B)) means A is at or to the far side of B, typically so as to be hidden by it. + + + Below + (A, (Below, B)) means A is in a place or position that is lower than the position of B. + + + Between + (A, (Between, (B, C))) means A is in the space or interval separating B and C. + + + Bilateral-to + (A, (Bilateral, B)) means A is on both sides of B or affects both sides of B. + + + Bottom-edge-of + (A, (Bottom-edge-of, B)) means A is on the bottom most part or or near the boundary of B. + + relatedTag + Left-edge-of + Right-edge-of + Top-edge-of + + + + Boundary-of + (A, (Boundary-of, B)) means A is on or part of the edge or boundary of B. + + + Center-of + (A, (Center-of, B)) means A is at a point or or in an area that is approximately central within B. + + + Close-to + (A, (Close-to, B)) means A is at a small distance from or is located near in space to B. + + + Far-from + (A, (Far-from, B)) means A is at a large distance from or is not located near in space to B. + + + In-front-of + (A, (In-front-of, B)) means A is in a position just ahead or at the front part of B, potentially partially blocking B from view. + + + Left-edge-of + (A, (Left-edge-of, B)) means A is located on the left side of B on or near the boundary of B. + + relatedTag + Bottom-edge-of + Right-edge-of + Top-edge-of + + + + Left-side-of + (A, (Left-side-of, B)) means A is located on the left side of B usually as part of B. + + relatedTag + Right-side-of + + + + Lower-center-of + (A, (Lower-center-of, B)) means A is situated on the lower center part of B (due south). This relation is often used to specify qualitative information about screen position. + + relatedTag + Center-of + Lower-left-of + Lower-right-of + Upper-center-of + Upper-right-of + + + + Lower-left-of + (A, (Lower-left-of, B)) means A is situated on the lower left part of B. This relation is often used to specify qualitative information about screen position. + + relatedTag + Center-of + Lower-center-of + Lower-right-of + Upper-center-of + Upper-left-of + Upper-right-of + + + + Lower-right-of + (A, (Lower-right-of, B)) means A is situated on the lower right part of B. This relation is often used to specify qualitative information about screen position. + + relatedTag + Center-of + Lower-center-of + Lower-left-of + Upper-left-of + Upper-center-of + Upper-left-of + Lower-right-of + + + + Outside-of + (A, (Outside-of, B)) means A is located in the space around but not including B. + + + Over + (A, (Over, B)) means A above is above B so as to cover or protect or A extends over the a general area as from a from a vantage point. + + + Right-edge-of + (A, (Right-edge-of, B)) means A is located on the right side of B on or near the boundary of B. + + relatedTag + Bottom-edge-of + Left-edge-of + Top-edge-of + + + + Right-side-of + (A, (Right-side-of, B)) means A is located on the right side of B usually as part of B. + + relatedTag + Left-side-of + + + + To-left-of + (A, (To-left-of, B)) means A is located on or directed toward the side to the west of B when B is facing north. This term is used when A is not part of B. + + + To-right-of + (A, (To-right-of, B)) means A is located on or directed toward the side to the east of B when B is facing north. This term is used when A is not part of B. + + + Top-edge-of + (A, (Top-edge-of, B)) means A is on the uppermost part or or near the boundary of B. + + relatedTag + Left-edge-of + Right-edge-of + Bottom-edge-of + + + + Top-of + (A, (Top-of, B)) means A is on the uppermost part, side, or surface of B. + + + Underneath + (A, (Underneath, B)) means A is situated directly below and may be concealed by B. + + + Upper-center-of + (A, (Upper-center-of, B)) means A is situated on the upper center part of B (due north). This relation is often used to specify qualitative information about screen position. + + relatedTag + Center-of + Lower-center-of + Lower-left-of + Lower-right-of + Upper-center-of + Upper-right-of + + + + Upper-left-of + (A, (Upper-left-of, B)) means A is situated on the upper left part of B. This relation is often used to specify qualitative information about screen position. + + relatedTag + Center-of + Lower-center-of + Lower-left-of + Lower-right-of + Upper-center-of + Upper-right-of + + + + Upper-right-of + (A, (Upper-right-of, B)) means A is situated on the upper right part of B. This relation is often used to specify qualitative information about screen position. + + relatedTag + Center-of + Lower-center-of + Lower-left-of + Upper-left-of + Upper-center-of + Lower-right-of + + + + Within + (A, (Within, B)) means A is on the inside of or contained in B. + + + + Temporal-relation + A relationship that includes a temporal or time-based component. + + After + (A, (After B)) means A happens at a time subsequent to a reference time related to B. + + + Asynchronous-with + (A, (Asynchronous-with, B)) means A happens at times not occurring at the same time or having the same period or phase as B. + + + Before + (A, (Before B)) means A happens at a time earlier in time or order than B. + + + During + (A, (During, B)) means A happens at some point in a given period of time in which B is ongoing. + + + Synchronous-with + (A, (Synchronous-with, B)) means A happens at occurs at the same time or rate as B. + + + Waiting-for + (A, (Waiting-for, B)) means A pauses for something to happen in B. + + + + + + + accelerationUnits + + defaultUnits + m-per-s^2 + + + m-per-s^2 + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + + angleUnits + + defaultUnits + radian + + + radian + + SIUnit + + + conversionFactor + 1.0 + + + + rad + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + degree + + conversionFactor + 0.0174533 + + + + + areaUnits + + defaultUnits + m^2 + + + m^2 + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + + currencyUnits + Units indicating the worth of something. + + defaultUnits + $ + + + dollar + + conversionFactor + 1.0 + + + + $ + + unitPrefix + + + unitSymbol + + + conversionFactor + 1.0 + + + + euro + + + point + + + + electricPotentialUnits + + defaultUnits + uv + + + v + + SIUnit + + + unitSymbol + + + conversionFactor + 0.000001 + + + + Volt + + SIUnit + + + conversionFactor + 0.000001 + + + + + frequencyUnits + + defaultUnits + Hz + + + hertz + + SIUnit + + + conversionFactor + 1.0 + + + + Hz + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + + intensityUnits + + defaultUnits + dB + + + dB + Intensity expressed as ratio to a threshold. May be used for sound intensity. + + unitSymbol + + + conversionFactor + 1.0 + + + + candela + Units used to express light intensity. + + SIUnit + + + + cd + Units used to express light intensity. + + SIUnit + + + unitSymbol + + + + + jerkUnits + + defaultUnits + m-per-s^3 + + + m-per-s^3 + + unitSymbol + + + conversionFactor + 1.0 + + + + + magneticFieldUnits + Units used to magnetic field intensity. + + defaultUnits + fT + + + tesla + + SIUnit + + + conversionFactor + 10^-15 + + + + T + + SIUnit + + + unitSymbol + + + conversionFactor + 10^-15 + + + + + memorySizeUnits + + defaultUnits + B + + + byte + + SIUnit + + + conversionFactor + 1.0 + + + + B + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + + physicalLengthUnits + + defaultUnits + m + + + foot + + conversionFactor + 0.3048 + + + + inch + + conversionFactor + 0.0254 + + + + meter + + SIUnit + + + conversionFactor + 1.0 + + + + metre + + SIUnit + + + conversionFactor + 1.0 + + + + m + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + mile + + conversionFactor + 1609.34 + + + + + speedUnits + + defaultUnits + m-per-s + + + m-per-s + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + mph + + unitSymbol + + + conversionFactor + 0.44704 + + + + kph + + unitSymbol + + + conversionFactor + 0.277778 + + + + + temperatureUnits + + degree Celsius + + SIUnit + + + conversionFactor + 1.0 + + + + oC + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + + timeUnits + + defaultUnits + s + + + second + + SIUnit + + + conversionFactor + 1.0 + + + + s + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + day + + conversionFactor + 86400 + + + + minute + + conversionFactor + 60 + + + + hour + Should be in 24-hour format. + + conversionFactor + 3600 + + + + + volumeUnits + + defaultUnits + m^3 + + + m^3 + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + + weightUnits + + defaultUnits + g + + + g + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + gram + + SIUnit + + + conversionFactor + 1.0 + + + + pound + + conversionFactor + 453.592 + + + + lb + + conversionFactor + 453.592 + + + + + + + deca + SI unit multiple representing 10^1. + + SIUnitModifier + + + conversionFactor + 10.0 + + + + da + SI unit multiple representing 10^1. + + SIUnitSymbolModifier + + + conversionFactor + 10.0 + + + + hecto + SI unit multiple representing 10^2. + + SIUnitModifier + + + conversionFactor + 100.0 + + + + h + SI unit multiple representing 10^2. + + SIUnitSymbolModifier + + + conversionFactor + 100.0 + + + + kilo + SI unit multiple representing 10^3. + + SIUnitModifier + + + conversionFactor + 1000.0 + + + + k + SI unit multiple representing 10^3. + + SIUnitSymbolModifier + + + conversionFactor + 1000.0 + + + + mega + SI unit multiple representing 10^6. + + SIUnitModifier + + + conversionFactor + 10^6 + + + + M + SI unit multiple representing 10^6. + + SIUnitSymbolModifier + + + conversionFactor + 10^6 + + + + giga + SI unit multiple representing 10^9. + + SIUnitModifier + + + conversionFactor + 10^9 + + + + G + SI unit multiple representing 10^9. + + SIUnitSymbolModifier + + + conversionFactor + 10^9 + + + + tera + SI unit multiple representing 10^12. + + SIUnitModifier + + + conversionFactor + 10^12 + + + + T + SI unit multiple representing 10^12. + + SIUnitSymbolModifier + + + conversionFactor + 10^12 + + + + peta + SI unit multiple representing 10^15. + + SIUnitModifier + + + conversionFactor + 10^15 + + + + P + SI unit multiple representing 10^15. + + SIUnitSymbolModifier + + + conversionFactor + 10^15 + + + + exa + SI unit multiple representing 10^18. + + SIUnitModifier + + + conversionFactor + 10^18 + + + + E + SI unit multiple representing 10^18. + + SIUnitSymbolModifier + + + conversionFactor + 10^18 + + + + zetta + SI unit multiple representing 10^21. + + SIUnitModifier + + + conversionFactor + 10^21 + + + + Z + SI unit multiple representing 10^21. + + SIUnitSymbolModifier + + + conversionFactor + 10^21 + + + + yotta + SI unit multiple representing 10^24. + + SIUnitModifier + + + conversionFactor + 10^24 + + + + Y + SI unit multiple representing 10^24. + + SIUnitSymbolModifier + + + conversionFactor + 10^24 + + + + deci + SI unit submultiple representing 10^-1. + + SIUnitModifier + + + conversionFactor + 0.1 + + + + d + SI unit submultiple representing 10^-1. + + SIUnitSymbolModifier + + + conversionFactor + 0.1 + + + + centi + SI unit submultiple representing 10^-2. + + SIUnitModifier + + + conversionFactor + 0.01 + + + + c + SI unit submultiple representing 10^-2. + + SIUnitSymbolModifier + + + conversionFactor + 0.01 + + + + milli + SI unit submultiple representing 10^-3. + + SIUnitModifier + + + conversionFactor + 0.001 + + + + m + SI unit submultiple representing 10^-3. + + SIUnitSymbolModifier + + + conversionFactor + 0.001 + + + + micro + SI unit submultiple representing 10^-6. + + SIUnitModifier + + + conversionFactor + 10^-6 + + + + u + SI unit submultiple representing 10^-6. + + SIUnitSymbolModifier + + + conversionFactor + 10^-6 + + + + nano + SI unit submultiple representing 10^-9. + + SIUnitModifier + + + conversionFactor + 10^-9 + + + + n + SI unit submultiple representing 10^-9. + + SIUnitSymbolModifier + + + conversionFactor + 10^-9 + + + + pico + SI unit submultiple representing 10^-12. + + SIUnitModifier + + + conversionFactor + 10^-12 + + + + p + SI unit submultiple representing 10^-12. + + SIUnitSymbolModifier + + + conversionFactor + 10^-12 + + + + femto + SI unit submultiple representing 10^-15. + + SIUnitModifier + + + conversionFactor + 10^-15 + + + + f + SI unit submultiple representing 10^-15. + + SIUnitSymbolModifier + + + conversionFactor + 10^-15 + + + + atto + SI unit submultiple representing 10^-18. + + SIUnitModifier + + + conversionFactor + 10^-18 + + + + a + SI unit submultiple representing 10^-18. + + SIUnitSymbolModifier + + + conversionFactor + 10^-18 + + + + zepto + SI unit submultiple representing 10^-21. + + SIUnitModifier + + + conversionFactor + 10^-21 + + + + z + SI unit submultiple representing 10^-21. + + SIUnitSymbolModifier + + + conversionFactor + 10^-21 + + + + yocto + SI unit submultiple representing 10^-24. + + SIUnitModifier + + + conversionFactor + 10^-24 + + + + y + SI unit submultiple representing 10^-24. + + SIUnitSymbolModifier + + + conversionFactor + 10^-24 + + + + + + dateTimeClass + Date-times should conform to ISO8601 date-time format YYYY-MM-DDThh:mm:ss. Any variation on the full form is allowed. + + allowedCharacter + digits + T + - + : + + + + nameClass + Value class designating values that have the characteristics of node names. The allowed characters are alphanumeric, hyphen, and underbar. + + allowedCharacter + letters + digits + _ + - + + + + numericClass + Value must be a valid numerical value. + + allowedCharacter + digits + E + e + + + - + . + + + + posixPath + Posix path specification. + + allowedCharacter + digits + letters + / + : + + + + textClass + Value class designating values that have the characteristics of text such as in descriptions. + + allowedCharacter + letters + digits + blank + + + - + : + ; + . + / + ( + ) + ? + * + % + $ + @ + + + + + + allowedCharacter + A schema attribute of value classes specifying a special character that is allowed in expressing the value of a placeholder. Normally the allowed characters are listed individually. However, the word letters designates the upper and lower case alphabetic characters and the word digits designates the digits 0-9. The word blank designates the blank character. + + valueClassProperty + + + + conversionFactor + The multiplicative factor to multiply these units to convert to default units. + + unitProperty + + + unitModifierProperty + + + + deprecatedFrom + Indicates that this element is deprecated. The value of the attribute is the latest schema version in which the element appeared in undeprecated form. + + elementProperty + + + + defaultUnits + A schema attribute of unit classes specifying the default units to use if the placeholder has a unit class but the substituted value has no units. + + unitClassProperty + + + + extensionAllowed + A schema attribute indicating that users can add unlimited levels of child nodes under this tag. This tag is propagated to child nodes with the exception of the hashtag placeholders. + + boolProperty + + + nodeProperty + + + isInheritedProperty + + + + inLibrary + Indicates this schema element came from the named library schema, not the standard schema. This attribute is added by tools when a library schema is merged into its partnered standard schema. + + elementProperty + + + + recommended + A schema attribute indicating that the event-level HED string should include this tag. + + boolProperty + + + nodeProperty + + + + relatedTag + A schema attribute suggesting HED tags that are closely related to this tag. This attribute is used by tagging tools. + + nodeProperty + + + isInheritedProperty + + + + requireChild + A schema attribute indicating that one of the node elements descendants must be included when using this tag. + + boolProperty + + + nodeProperty + + + + required + A schema attribute indicating that every event-level HED string should include this tag. + + boolProperty + + + nodeProperty + + + + reserved + A schema attribute indicating that this tag has special meaning and requires special handling by tools. + + boolProperty + + + nodeProperty + + + + rooted + Indicates a top-level library schema node is identical to a node of the same name in the partnered standard schema. This attribute can only appear in nodes that have the inLibrary schema attribute. + + nodeProperty + + + + SIUnit + A schema attribute indicating that this unit element is an SI unit and can be modified by multiple and submultiple names. Note that some units such as byte are designated as SI units although they are not part of the standard. + + boolProperty + + + unitProperty + + + + SIUnitModifier + A schema attribute indicating that this SI unit modifier represents a multiple or submultiple of a base unit rather than a unit symbol. + + boolProperty + + + unitModifierProperty + + + + SIUnitSymbolModifier + A schema attribute indicating that this SI unit modifier represents a multiple or submultiple of a unit symbol rather than a base symbol. + + boolProperty + + + unitModifierProperty + + + + suggestedTag + A schema attribute that indicates another tag that is often associated with this tag. This attribute is used by tagging tools to provide tagging suggestions. + + nodeProperty + + + isInheritedProperty + + + + tagGroup + A schema attribute indicating the tag can only appear inside a tag group. + + boolProperty + + + nodeProperty + + + + takesValue + A schema attribute indicating the tag is a hashtag placeholder that is expected to be replaced with a user-defined value. + + boolProperty + + + nodeProperty + + + + topLevelTagGroup + A schema attribute indicating that this tag (or its descendants) can only appear in a top-level tag group. A tag group can have at most one tag with this attribute. + + boolProperty + + + nodeProperty + + + + unique + A schema attribute indicating that only one of this tag or its descendants can be used in the event-level HED string. + + boolProperty + + + nodeProperty + + + + unitClass + A schema attribute specifying which unit class this value tag belongs to. + + nodeProperty + + + + unitPrefix + A schema attribute applied specifically to unit elements to designate that the unit indicator is a prefix (e.g., dollar sign in the currency units). + + boolProperty + + + unitProperty + + + + unitSymbol + A schema attribute indicating this tag is an abbreviation or symbol representing a type of unit. Unit symbols represent both the singular and the plural and thus cannot be pluralized. + + boolProperty + + + unitProperty + + + + valueClass + A schema attribute specifying which value class this value tag belongs to. + + nodeProperty + + + + + + boolProperty + Indicates that the schema attribute represents something that is either true or false and does not have a value. Attributes without this value are assumed to have string values. + + + elementProperty + Indicates this schema attribute can apply to any type of element(tag term, unit class, etc). + + + isInheritedProperty + Indicates that this attribute is inherited by child nodes. This property only applies to schema attributes for nodes. + + + nodeProperty + Indicates this schema attribute applies to node (tag-term) elements. This was added to allow for an attribute to apply to multiple elements. + + + unitClassProperty + Indicates that the schema attribute is meant to be applied to unit classes. + + + unitModifierProperty + Indicates that the schema attribute is meant to be applied to unit modifier classes. + + + unitProperty + Indicates that the schema attribute is meant to be applied to units within a unit class. + + + valueClassProperty + Indicates that the schema attribute is meant to be applied to value classes. + + + diff --git a/hed/schema/schema_data/HED_testlib_3.0.0.xml b/hed/schema/schema_data/HED_testlib_3.0.0.xml new file mode 100644 index 000000000..55ece286e --- /dev/null +++ b/hed/schema/schema_data/HED_testlib_3.0.0.xml @@ -0,0 +1,7407 @@ + + + This schema is designed to be lazy partnered with testlib_2.0.0 but conflicts with testlib_2.1.0. + + + Event + Something that happens at a given time and (typically) place. Elements of this tag subtree designate the general category in which an event falls. + + suggestedTag + Task-property + + + Sensory-event + Something perceivable by the participant. An event meant to be an experimental stimulus should include the tag Task-property/Task-event-role/Experimental-stimulus. + + suggestedTag + Task-event-role + Sensory-presentation + + + + Agent-action + Any action engaged in by an agent (see the Agent subtree for agent categories). A participant response to an experiment stimulus should include the tag Agent-property/Agent-task-role/Experiment-participant. + + suggestedTag + Task-event-role + Agent + + + + Data-feature + An event marking the occurrence of a data feature such as an interictal spike or alpha burst that is often added post hoc to the data record. + + suggestedTag + Data-property + + + + Experiment-control + An event pertaining to the physical control of the experiment during its operation. + + + Experiment-procedure + An event indicating an experimental procedure, as in performing a saliva swab during the experiment or administering a survey. + + + Experiment-structure + An event specifying a change-point of the structure of experiment. This event is typically used to indicate a change in experimental conditions or tasks. + + + Measurement-event + A discrete measure returned by an instrument. + + suggestedTag + Data-property + + + + + Agent + Someone or something that takes an active role or produces a specified effect.The role or effect may be implicit. Being alive or performing an activity such as a computation may qualify something to be an agent. An agent may also be something that simulates something else. + + suggestedTag + Agent-property + + + Animal-agent + An agent that is an animal. + + + Avatar-agent + An agent associated with an icon or avatar representing another agent. + + + Controller-agent + An agent experiment control software or hardware. + + + Human-agent + A person who takes an active role or produces a specified effect. + + + Robotic-agent + An agent mechanical device capable of performing a variety of often complex tasks on command or by being programmed in advance. + + + Software-agent + An agent computer program. + + + + F-nonextension + + inLibrary + testlib + + + SubnodeF6 + + inLibrary + testlib + + + + SubnodeF1 + + inLibrary + testlib + + + + SubnodeF2 + + inLibrary + testlib + + + + + Action + Do something. + + extensionAllowed + + + Communicate + Convey knowledge of or information about something. + + Communicate-gesturally + Communicate nonverbally using visible bodily actions, either in place of speech or together and in parallel with spoken words. Gestures include movement of the hands, face, or other parts of the body. + + relatedTag + Move-face + Move-upper-extremity + + + Clap-hands + Strike the palms of against one another resoundingly, and usually repeatedly, especially to express approval. + + + Clear-throat + Cough slightly so as to speak more clearly, attract attention, or to express hesitancy before saying something awkward. + + relatedTag + Move-face + Move-head + + + + Frown + Express disapproval, displeasure, or concentration, typically by turning down the corners of the mouth. + + relatedTag + Move-face + + + + Grimace + Make a twisted expression, typically expressing disgust, pain, or wry amusement. + + relatedTag + Move-face + + + + Nod-head + Tilt head in alternating up and down arcs along the sagittal plane. It is most commonly, but not universally, used to indicate agreement, acceptance, or acknowledgement. + + relatedTag + Move-head + + + + Pump-fist + Raise with fist clenched in triumph or affirmation. + + relatedTag + Move-upper-extremity + + + + Raise-eyebrows + Move eyebrows upward. + + relatedTag + Move-face + Move-eyes + + + + Shake-fist + Clench hand into a fist and shake to demonstrate anger. + + relatedTag + Move-upper-extremity + + + + Shake-head + Turn head from side to side as a way of showing disagreement or refusal. + + relatedTag + Move-head + + + + Shhh + Place finger over lips and possibly uttering the syllable shhh to indicate the need to be quiet. + + relatedTag + Move-upper-extremity + + + + Shrug + Lift shoulders up towards head to indicate a lack of knowledge about a particular topic. + + relatedTag + Move-upper-extremity + Move-torso + + + + Smile + Form facial features into a pleased, kind, or amused expression, typically with the corners of the mouth turned up and the front teeth exposed. + + relatedTag + Move-face + + + + Spread-hands + Spread hands apart to indicate ignorance. + + relatedTag + Move-upper-extremity + + + + Thumb-up + Extend the thumb upward to indicate approval. + + relatedTag + Move-upper-extremity + + + + Thumbs-down + Extend the thumb downward to indicate disapproval. + + relatedTag + Move-upper-extremity + + + + Wave + Raise hand and move left and right, as a greeting or sign of departure. + + relatedTag + Move-upper-extremity + + + + Widen-eyes + Open eyes and possibly with eyebrows lifted especially to express surprise or fear. + + relatedTag + Move-face + Move-eyes + + + + Wink + Close and open one eye quickly, typically to indicate that something is a joke or a secret or as a signal of affection or greeting. + + relatedTag + Move-face + Move-eyes + + + + + Communicate-musically + Communicate using music. + + Hum + Make a low, steady continuous sound like that of a bee. Sing with the lips closed and without uttering speech. + + + Play-instrument + Make musical sounds using an instrument. + + + Sing + Produce musical tones by means of the voice. + + + Vocalize + Utter vocal sounds. + + + Whistle + Produce a shrill clear sound by forcing breath out or air in through the puckered lips. + + + + Communicate-vocally + Communicate using mouth or vocal cords. + + Cry + Shed tears associated with emotions, usually sadness but also joy or frustration. + + + Groan + Make a deep inarticulate sound in response to pain or despair. + + + Laugh + Make the spontaneous sounds and movements of the face and body that are the instinctive expressions of lively amusement and sometimes also of contempt or derision. + + + Scream + Make loud, vociferous cries or yells to express pain, excitement, or fear. + + + Shout + Say something very loudly. + + + Sigh + Emit a long, deep, audible breath expressing sadness, relief, tiredness, or a similar feeling. + + + Speak + Communicate using spoken language. + + + Whisper + Speak very softly using breath without vocal cords. + + + + + Move + Move in a specified direction or manner. Change position or posture. + + Breathe + Inhale or exhale during respiration. + + Blow + Expel air through pursed lips. + + + Cough + Suddenly and audibly expel air from the lungs through a partially closed glottis, preceded by inhalation. + + + Exhale + Blow out or expel breath. + + + Hiccup + Involuntarily spasm the diaphragm and respiratory organs, with a sudden closure of the glottis and a characteristic sound like that of a cough. + + + Hold-breath + Interrupt normal breathing by ceasing to inhale or exhale. + + + Inhale + Draw in with the breath through the nose or mouth. + + + Sneeze + Suddenly and violently expel breath through the nose and mouth. + + + Sniff + Draw in air audibly through the nose to detect a smell, to stop it from running, or to express contempt. + + + + Move-body + Move entire body. + + Bend + Move body in a bowed or curved manner. + + + Dance + Perform a purposefully selected sequences of human movement often with aesthetic or symbolic value. Move rhythmically to music, typically following a set sequence of steps. + + + Fall-down + Lose balance and collapse. + + + Flex + Cause a muscle to stand out by contracting or tensing it. Bend a limb or joint. + + + Jerk + Make a quick, sharp, sudden movement. + + + Lie-down + Move to a horizontal or resting position. + + + Recover-balance + Return to a stable, upright body position. + + + Shudder + Tremble convulsively, sometimes as a result of fear or revulsion. + + + Sit-down + Move from a standing to a sitting position. + + + Sit-up + Move from lying down to a sitting position. + + + Stand-up + Move from a sitting to a standing position. + + + Stretch + Straighten or extend body or a part of body to its full length, typically so as to tighten muscles or in order to reach something. + + + Stumble + Trip or momentarily lose balance and almost fall. + + + Turn + Change or cause to change direction. + + + + Move-body-part + Move one part of a body. + + Move-eyes + Move eyes. + + Blink + Shut and open the eyes quickly. + + + Close-eyes + Lower and keep eyelids in a closed position. + + + Fixate + Direct eyes to a specific point or target. + + + Inhibit-blinks + Purposely prevent blinking. + + + Open-eyes + Raise eyelids to expose pupil. + + + Saccade + Move eyes rapidly between fixation points. + + + Squint + Squeeze one or both eyes partly closed in an attempt to see more clearly or as a reaction to strong light. + + + Stare + Look fixedly or vacantly at someone or something with eyes wide open. + + + + Move-face + Move the face or jaw. + + Bite + Seize with teeth or jaws an object or organism so as to grip or break the surface covering. + + + Burp + Noisily release air from the stomach through the mouth. Belch. + + + Chew + Repeatedly grinding, tearing, and or crushing with teeth or jaws. + + + Gurgle + Make a hollow bubbling sound like that made by water running out of a bottle. + + + Swallow + Cause or allow something, especially food or drink to pass down the throat. + + Gulp + Swallow quickly or in large mouthfuls, often audibly, sometimes to indicate apprehension. + + + + Yawn + Take a deep involuntary inhalation with the mouth open often as a sign of drowsiness or boredom. + + + + Move-head + Move head. + + Lift-head + Tilt head back lifting chin. + + + Lower-head + Move head downward so that eyes are in a lower position. + + + Turn-head + Rotate head horizontally to look in a different direction. + + + + Move-lower-extremity + Move leg and/or foot. + + Curl-toes + Bend toes sometimes to grip. + + + Hop + Jump on one foot. + + + Jog + Run at a trot to exercise. + + + Jump + Move off the ground or other surface through sudden muscular effort in the legs. + + + Kick + Strike out or flail with the foot or feet. Strike using the leg, in unison usually with an area of the knee or lower using the foot. + + + Pedal + Move by working the pedals of a bicycle or other machine. + + + Press-foot + Move by pressing foot. + + + Run + Travel on foot at a fast pace. + + + Step + Put one leg in front of the other and shift weight onto it. + + Heel-strike + Strike the ground with the heel during a step. + + + Toe-off + Push with toe as part of a stride. + + + + Trot + Run at a moderate pace, typically with short steps. + + + Walk + Move at a regular pace by lifting and setting down each foot in turn never having both feet off the ground at once. + + + + Move-torso + Move body trunk. + + + Move-upper-extremity + Move arm, shoulder, and/or hand. + + Drop + Let or cause to fall vertically. + + + Grab + Seize suddenly or quickly. Snatch or clutch. + + + Grasp + Seize and hold firmly. + + + Hold-down + Prevent someone or something from moving by holding them firmly. + + + Lift + Raising something to higher position. + + + Make-fist + Close hand tightly with the fingers bent against the palm. + + + Point + Draw attention to something by extending a finger or arm. + + + Press + Apply pressure to something to flatten, shape, smooth or depress it. This action tag should be used to indicate key presses and mouse clicks. + + relatedTag + Push + + + + Push + Apply force in order to move something away. Use Press to indicate a key press or mouse click. + + relatedTag + Press + + + + Reach + Stretch out your arm in order to get or touch something. + + + Release + Make available or set free. + + + Retract + Draw or pull back. + + + Scratch + Drag claws or nails over a surface or on skin. + + + Snap-fingers + Make a noise by pushing second finger hard against thumb and then releasing it suddenly so that it hits the base of the thumb. + + + Touch + Come into or be in contact with. + + + + + + Perceive + Produce an internal, conscious image through stimulating a sensory system. + + Hear + Give attention to a sound. + + + See + Direct gaze toward someone or something or in a specified direction. + + + Sense-by-touch + Sense something through receptors in the skin. + + + Smell + Inhale in order to ascertain an odor or scent. + + + Taste + Sense a flavor in the mouth and throat on contact with a substance. + + + + Perform + Carry out or accomplish an action, task, or function. + + Close + Act as to blocked against entry or passage. + + + Collide-with + Hit with force when moving. + + + Halt + Bring or come to an abrupt stop. + + + Modify + Change something. + + + Open + Widen an aperture, door, or gap, especially one allowing access to something. + + + Operate + Control the functioning of a machine, process, or system. + + + Play + Engage in activity for enjoyment and recreation rather than a serious or practical purpose. + + + Read + Interpret something that is written or printed. + + + Repeat + Make do or perform again. + + + Rest + Be inactive in order to regain strength, health, or energy. + + + Write + Communicate or express by means of letters or symbols written or imprinted on a surface. + + + + Think + Direct the mind toward someone or something or use the mind actively to form connected ideas. + + Allow + Allow access to something such as allowing a car to pass. + + + Attend-to + Focus mental experience on specific targets. + + + Count + Tally items either silently or aloud. + + + Deny + Refuse to give or grant something requested or desired by someone. + + + Detect + Discover or identify the presence or existence of something. + + + Discriminate + Recognize a distinction. + + + Encode + Convert information or an instruction into a particular form. + + + Evade + Escape or avoid, especially by cleverness or trickery. + + + Generate + Cause something, especially an emotion or situation to arise or come about. + + + Identify + Establish or indicate who or what someone or something is. + + + Imagine + Form a mental image or concept of something. + + + Judge + Evaluate evidence to make a decision or form a belief. + + + Learn + Adaptively change behavior as the result of experience. + + + Memorize + Adaptively change behavior as the result of experience. + + + Plan + Think about the activities required to achieve a desired goal. + + + Predict + Say or estimate that something will happen or will be a consequence of something without having exact informaton. + + + Recall + Remember information by mental effort. + + + Recognize + Identify someone or something from having encountered them before. + + + Respond + React to something such as a treatment or a stimulus. + + + Switch-attention + Transfer attention from one focus to another. + + + Track + Follow a person, animal, or object through space or time. + + + + + Item + An independently existing thing (living or nonliving). + + extensionAllowed + + + Biological-item + An entity that is biological, that is related to living organisms. + + Anatomical-item + A biological structure, system, fluid or other substance excluding single molecular entities. + + Body + The biological structure representing an organism. + + + Body-part + Any part of an organism. + + Head + The upper part of the human body, or the front or upper part of the body of an animal, typically separated from the rest of the body by a neck, and containing the brain, mouth, and sense organs. + + Ear + A sense organ needed for the detection of sound and for establishing balance. + + + Face + The anterior portion of the head extending from the forehead to the chin and ear to ear. The facial structures contain the eyes, nose and mouth, cheeks and jaws. + + Cheek + The fleshy part of the face bounded by the eyes, nose, ear, and jaw line. + + + Chin + The part of the face below the lower lip and including the protruding part of the lower jaw. + + + Eye + The organ of sight or vision. + + + Eyebrow + The arched strip of hair on the bony ridge above each eye socket. + + + Forehead + The part of the face between the eyebrows and the normal hairline. + + + Lip + Fleshy fold which surrounds the opening of the mouth. + + + Mouth + The proximal portion of the digestive tract, containing the oral cavity and bounded by the oral opening. + + + Nose + A structure of special sense serving as an organ of the sense of smell and as an entrance to the respiratory tract. + + + Teeth + The hard bonelike structures in the jaws. A collection of teeth arranged in some pattern in the mouth or other part of the body. + + + + Hair + The filamentous outgrowth of the epidermis. + + + + Lower-extremity + Refers to the whole inferior limb (leg and/or foot). + + Ankle + A gliding joint between the distal ends of the tibia and fibula and the proximal end of the talus. + + + Calf + The fleshy part at the back of the leg below the knee. + + + Foot + The structure found below the ankle joint required for locomotion. + + Big-toe + The largest toe on the inner side of the foot. + + + Heel + The back of the foot below the ankle. + + + Instep + The part of the foot between the ball and the heel on the inner side. + + + Little-toe + The smallest toe located on the outer side of the foot. + + + Toes + The terminal digits of the foot. + + + + Knee + A joint connecting the lower part of the femur with the upper part of the tibia. + + + Shin + Front part of the leg below the knee. + + + Thigh + Upper part of the leg between hip and knee. + + + + Torso + The body excluding the head and neck and limbs. + + Buttocks + The round fleshy parts that form the lower rear area of a human trunk. + + + Gentalia + The external organs of reproduction. + + deprecatedFrom + 8.1.0 + + + + Hip + The lateral prominence of the pelvis from the waist to the thigh. + + + Torso-back + The rear surface of the human body from the shoulders to the hips. + + + Torso-chest + The anterior side of the thorax from the neck to the abdomen. + + + Waist + The abdominal circumference at the navel. + + + + Upper-extremity + Refers to the whole superior limb (shoulder, arm, elbow, wrist, hand). + + Elbow + A type of hinge joint located between the forearm and upper arm. + + + Forearm + Lower part of the arm between the elbow and wrist. + + + Hand + The distal portion of the upper extremity. It consists of the carpus, metacarpus, and digits. + + Finger + Any of the digits of the hand. + + Index-finger + The second finger from the radial side of the hand, next to the thumb. + + + Little-finger + The fifth and smallest finger from the radial side of the hand. + + + Middle-finger + The middle or third finger from the radial side of the hand. + + + Ring-finger + The fourth finger from the radial side of the hand. + + + Thumb + The thick and short hand digit which is next to the index finger in humans. + + + + Knuckles + A part of a finger at a joint where the bone is near the surface, especially where the finger joins the hand. + + + Palm + The part of the inner surface of the hand that extends from the wrist to the bases of the fingers. + + + + Shoulder + Joint attaching upper arm to trunk. + + + Upper-arm + Portion of arm between shoulder and elbow. + + + Wrist + A joint between the distal end of the radius and the proximal row of carpal bones. + + + + + + Organism + A living entity, more specifically a biological entity that consists of one or more cells and is capable of genomic replication (independently or not). + + Animal + A living organism that has membranous cell walls, requires oxygen and organic foods, and is capable of voluntary movement. + + + Human + The bipedal primate mammal Homo sapiens. + + + Plant + Any living organism that typically synthesizes its food from inorganic substances and possesses cellulose cell walls. + + + + + Language-item + An entity related to a systematic means of communicating by the use of sounds, symbols, or gestures. + + suggestedTag + Sensory-presentation + + + Character + A mark or symbol used in writing. + + + Clause + A unit of grammatical organization next below the sentence in rank, usually consisting of a subject and predicate. + + + Glyph + A hieroglyphic character, symbol, or pictograph. + + + Nonword + A group of letters or speech sounds that looks or sounds like a word but that is not accepted as such by native speakers. + + + Paragraph + A distinct section of a piece of writing, usually dealing with a single theme. + + + Phoneme + A speech sound that is distinguished by the speakers of a particular language. + + + Phrase + A phrase is a group of words functioning as a single unit in the syntax of a sentence. + + + Sentence + A set of words that is complete in itself, conveying a statement, question, exclamation, or command and typically containing an explicit or implied subject and a predicate containing a finite verb. + + + Syllable + A unit of spoken language larger than a phoneme. + + + Textblock + A block of text. + + + Word + A word is the smallest free form (an item that may be expressed in isolation with semantic or pragmatic content) in a language. + + + + Object + Something perceptible by one or more of the senses, especially by vision or touch. A material thing. + + suggestedTag + Sensory-presentation + + + Geometric-object + An object or a representation that has structure and topology in space. + + 2D-shape + A planar, two-dimensional shape. + + Arrow + A shape with a pointed end indicating direction. + + + Clockface + The dial face of a clock. A location identifier based on clockface numbering or anatomic subregion. + + + Cross + A figure or mark formed by two intersecting lines crossing at their midpoints. + + + Dash + A horizontal stroke in writing or printing to mark a pause or break in sense or to represent omitted letters or words. + + + Ellipse + A closed plane curve resulting from the intersection of a circular cone and a plane cutting completely through it, especially a plane not parallel to the base. + + Circle + A ring-shaped structure with every point equidistant from the center. + + + + Rectangle + A parallelogram with four right angles. + + Square + A square is a special rectangle with four equal sides. + + + + Single-point + A point is a geometric entity that is located in a zero-dimensional spatial region and whose position is defined by its coordinates in some coordinate system. + + + Star + A conventional or stylized representation of a star, typically one having five or more points. + + + Triangle + A three-sided polygon. + + + + 3D-shape + A geometric three-dimensional shape. + + Box + A square or rectangular vessel, usually made of cardboard or plastic. + + Cube + A solid or semi-solid in the shape of a three dimensional square. + + + + Cone + A shape whose base is a circle and whose sides taper up to a point. + + + Cylinder + A surface formed by circles of a given radius that are contained in a plane perpendicular to a given axis, whose centers align on the axis. + + + Ellipsoid + A closed plane curve resulting from the intersection of a circular cone and a plane cutting completely through it, especially a plane not parallel to the base. + + Sphere + A solid or hollow three-dimensional object bounded by a closed surface such that every point on the surface is equidistant from the center. + + + + Pyramid + A polyhedron of which one face is a polygon of any number of sides, and the other faces are triangles with a common vertex. + + + + Pattern + An arrangement of objects, facts, behaviors, or other things which have scientific, mathematical, geometric, statistical, or other meaning. + + Dots + A small round mark or spot. + + + LED-pattern + A pattern created by lighting selected members of a fixed light emitting diode array. + + + + + Ingestible-object + Something that can be taken into the body by the mouth for digestion or absorption. + + + Man-made-object + Something constructed by human means. + + Building + A structure that has a roof and walls and stands more or less permanently in one place. + + Attic + A room or a space immediately below the roof of a building. + + + Basement + The part of a building that is wholly or partly below ground level. + + + Entrance + The means or place of entry. + + + Roof + A roof is the covering on the uppermost part of a building which provides protection from animals and weather, notably rain, but also heat, wind and sunlight. + + + Room + An area within a building enclosed by walls and floor and ceiling. + + + + Clothing + A covering designed to be worn on the body. + + + Device + An object contrived for a specific purpose. + + Assistive-device + A device that help an individual accomplish a task. + + Glasses + Frames with lenses worn in front of the eye for vision correction, eye protection, or protection from UV rays. + + + Writing-device + A device used for writing. + + Pen + A common writing instrument used to apply ink to a surface for writing or drawing. + + + Pencil + An implement for writing or drawing that is constructed of a narrow solid pigment core in a protective casing that prevents the core from being broken or marking the hand. + + + + + Computing-device + An electronic device which take inputs and processes results from the inputs. + + Cellphone + A telephone with access to a cellular radio system so it can be used over a wide area, without a physical connection to a network. + + + Desktop-computer + A computer suitable for use at an ordinary desk. + + + Laptop-computer + A computer that is portable and suitable for use while traveling. + + + Tablet-computer + A small portable computer that accepts input directly on to its screen rather than via a keyboard or mouse. + + + + Engine + A motor is a machine designed to convert one or more forms of energy into mechanical energy. + + + IO-device + Hardware used by a human (or other system) to communicate with a computer. + + Input-device + A piece of equipment used to provide data and control signals to an information processing system such as a computer or information appliance. + + Computer-mouse + A hand-held pointing device that detects two-dimensional motion relative to a surface. + + Mouse-button + An electric switch on a computer mouse which can be pressed or clicked to select or interact with an element of a graphical user interface. + + + Scroll-wheel + A scroll wheel or mouse wheel is a wheel used for scrolling made of hard plastic with a rubbery surface usually located between the left and right mouse buttons and is positioned perpendicular to the mouse surface. + + + + Joystick + A control device that uses a movable handle to create two-axis input for a computer device. + + + Keyboard + A device consisting of mechanical keys that are pressed to create input to a computer. + + Keyboard-key + A button on a keyboard usually representing letters, numbers, functions, or symbols. + + # + Value of a keyboard key. + + takesValue + + + + + + Keypad + A device consisting of keys, usually in a block arrangement, that provides limited input to a system. + + Keypad-key + A key on a separate section of a computer keyboard that groups together numeric keys and those for mathematical or other special functions in an arrangement like that of a calculator. + + # + Value of keypad key. + + takesValue + + + + + + Microphone + A device designed to convert sound to an electrical signal. + + + Push-button + A switch designed to be operated by pressing a button. + + + + Output-device + Any piece of computer hardware equipment which converts information into human understandable form. + + Auditory-device + A device designed to produce sound. + + Headphones + An instrument that consists of a pair of small loudspeakers, or less commonly a single speaker, held close to ears and connected to a signal source such as an audio amplifier, radio, CD player or portable media player. + + + Loudspeaker + A device designed to convert electrical signals to sounds that can be heard. + + + + Display-device + An output device for presentation of information in visual or tactile form the latter used for example in tactile electronic displays for blind people. + + Computer-screen + An electronic device designed as a display or a physical device designed to be a protective meshwork. + + Screen-window + A part of a computer screen that contains a display different from the rest of the screen. A window is a graphical control element consisting of a visual area containing some of the graphical user interface of the program it belongs to and is framed by a window decoration. + + + + Head-mounted-display + An instrument that functions as a display device, worn on the head or as part of a helmet, that has a small display optic in front of one (monocular HMD) or each eye (binocular HMD). + + + LED-display + A LED display is a flat panel display that uses an array of light-emitting diodes as pixels for a video display. + + + + + Recording-device + A device that copies information in a signal into a persistent information bearer. + + EEG-recorder + A device for recording electric currents in the brain using electrodes applied to the scalp, to the surface of the brain, or placed within the substance of the brain. + + + File-storage + A device for recording digital information to a permanent media. + + + MEG-recorder + A device for measuring the magnetic fields produced by electrical activity in the brain, usually conducted externally. + + + Motion-capture + A device for recording the movement of objects or people. + + + Tape-recorder + A device for recording and reproduction usually using magnetic tape for storage that can be saved and played back. + + + + Touchscreen + A control component that operates an electronic device by pressing the display on the screen. + + + + Machine + A human-made device that uses power to apply forces and control movement to perform an action. + + + Measurement-device + A device in which a measure function inheres. + + Clock + A device designed to indicate the time of day or to measure the time duration of an event or action. + + Clock-face + A location identifier based on clockface numbering or anatomic subregion. + + + + + Robot + A mechanical device that sometimes resembles a living animal and is capable of performing a variety of often complex human tasks on command or by being programmed in advance. + + + Tool + A component that is not part of a device but is designed to support its assemby or operation. + + + + Document + A physical object, or electronic counterpart, that is characterized by containing writing which is meant to be human-readable. + + Book + A volume made up of pages fastened along one edge and enclosed between protective covers. + + + Letter + A written message addressed to a person or organization. + + + Note + A brief written record. + + + Notebook + A book for notes or memoranda. + + + Questionnaire + A document consisting of questions and possibly responses, depending on whether it has been filled out. + + + + Furnishing + Furniture, fittings, and other decorative accessories, such as curtains and carpets, for a house or room. + + + Manufactured-material + Substances created or extracted from raw materials. + + Ceramic + A hard, brittle, heat-resistant and corrosion-resistant material made by shaping and then firing a nonmetallic mineral, such as clay, at a high temperature. + + + Glass + A brittle transparent solid with irregular atomic structure. + + + Paper + A thin sheet material produced by mechanically or chemically processing cellulose fibres derived from wood, rags, grasses or other vegetable sources in water. + + + Plastic + Various high-molecular-weight thermoplastic or thermosetting polymers that are capable of being molded, extruded, drawn, or otherwise shaped and then hardened into a form. + + + Steel + An alloy made up of iron with typically a few tenths of a percent of carbon to improve its strength and fracture resistance compared to iron. + + + + Media + Media are audo/visual/audiovisual modes of communicating information for mass consumption. + + Media-clip + A short segment of media. + + Audio-clip + A short segment of audio. + + + Audiovisual-clip + A short media segment containing both audio and video. + + + Video-clip + A short segment of video. + + + + Visualization + An planned process that creates images, diagrams or animations from the input data. + + Animation + A form of graphical illustration that changes with time to give a sense of motion or represent dynamic changes in the portrayal. + + + Art-installation + A large-scale, mixed-media constructions, often designed for a specific place or for a temporary period of time. + + + Braille + A display using a system of raised dots that can be read with the fingers by people who are blind. + + + Image + Any record of an imaging event whether physical or electronic. + + Cartoon + A type of illustration, sometimes animated, typically in a non-realistic or semi-realistic style. The specific meaning has evolved over time, but the modern usage usually refers to either an image or series of images intended for satire, caricature, or humor. A motion picture that relies on a sequence of illustrations for its animation. + + + Drawing + A representation of an object or outlining a figure, plan, or sketch by means of lines. + + + Icon + A sign (such as a word or graphic symbol) whose form suggests its meaning. + + + Painting + A work produced through the art of painting. + + + Photograph + An image recorded by a camera. + + + + Movie + A sequence of images displayed in succession giving the illusion of continuous movement. + + + Outline-visualization + A visualization consisting of a line or set of lines enclosing or indicating the shape of an object in a sketch or diagram. + + + Point-light-visualization + A display in which action is depicted using a few points of light, often generated from discrete sensors in motion capture. + + + Sculpture + A two- or three-dimensional representative or abstract forms, especially by carving stone or wood or by casting metal or plaster. + + + Stick-figure-visualization + A drawing showing the head of a human being or animal as a circle and all other parts as straight lines. + + + + + Navigational-object + An object whose purpose is to assist directed movement from one location to another. + + Path + A trodden way. A way or track laid down for walking or made by continual treading. + + + Road + An open way for the passage of vehicles, persons, or animals on land. + + Lane + A defined path with physical dimensions through which an object or substance may traverse. + + + + Runway + A paved strip of ground on a landing field for the landing and takeoff of aircraft. + + + + Vehicle + A mobile machine which transports people or cargo. + + Aircraft + A vehicle which is able to travel through air in an atmosphere. + + + Bicycle + A human-powered, pedal-driven, single-track vehicle, having two wheels attached to a frame, one behind the other. + + + Boat + A watercraft of any size which is able to float or plane on water. + + + Car + A wheeled motor vehicle used primarily for the transportation of human passengers. + + + Cart + A cart is a vehicle which has two wheels and is designed to transport human passengers or cargo. + + + Tractor + A mobile machine specifically designed to deliver a high tractive effort at slow speeds, and mainly used for the purposes of hauling a trailer or machinery used in agriculture or construction. + + + Train + A connected line of railroad cars with or without a locomotive. + + + Truck + A motor vehicle which, as its primary funcion, transports cargo rather than human passangers. + + + + + Natural-object + Something that exists in or is produced by nature, and is not artificial or man-made. + + Mineral + A solid, homogeneous, inorganic substance occurring in nature and having a definite chemical composition. + + + Natural-feature + A feature that occurs in nature. A prominent or identifiable aspect, region, or site of interest. + + Field + An unbroken expanse as of ice or grassland. + + + Hill + A rounded elevation of limited extent rising above the surrounding land with local relief of less than 300m. + + + Mountain + A landform that extends above the surrounding terrain in a limited area. + + + River + A natural freshwater surface stream of considerable volume and a permanent or seasonal flow, moving in a definite channel toward a sea, lake, or another river. + + + Waterfall + A sudden descent of water over a step or ledge in the bed of a river. + + + + + + Sound + Mechanical vibrations transmitted by an elastic medium. Something that can be heard. + + Environmental-sound + Sounds occuring in the environment. An accumulation of noise pollution that occurs outside. This noise can be caused by transport, industrial, and recreational activities. + + Crowd-sound + Noise produced by a mixture of sounds from a large group of people. + + + Signal-noise + Any part of a signal that is not the true or original signal but is introduced by the communication mechanism. + + + + Musical-sound + Sound produced by continuous and regular vibrations, as opposed to noise. + + Instrument-sound + Sound produced by a musical instrument. + + Base-sound + + rooted + Instrument-sound + + + inLibrary + testlib + + + Base-subsound1 + + inLibrary + testlib + + + + Base-subsound2 + + inLibrary + testlib + + + + + Piano-sound + + rooted + Instrument-sound + + + inLibrary + testlib + + + Piano-subsound1 + + inLibrary + testlib + + + + Piano-subsound2 + + inLibrary + testlib + + + + Piano-subsound3 + + inLibrary + testlib + + + + + + Tone + A musical note, warble, or other sound used as a particular signal on a telephone or answering machine. + + + Vocalized-sound + Musical sound produced by vocal cords in a biological agent. + + + + Named-animal-sound + A sound recognizable as being associated with particular animals. + + Barking + Sharp explosive cries like sounds made by certain animals, especially a dog, fox, or seal. + + + Bleating + Wavering cries like sounds made by a sheep, goat, or calf. + + + Chirping + Short, sharp, high-pitched noises like sounds made by small birds or an insects. + + + Crowing + Loud shrill sounds characteristic of roosters. + + + Growling + Low guttural sounds like those that made in the throat by a hostile dog or other animal. + + + Meowing + Vocalizations like those made by as those cats. These sounds have diverse tones and are sometimes chattered, murmured or whispered. The purpose can be assertive. + + + Mooing + Deep vocal sounds like those made by a cow. + + + Purring + Low continuous vibratory sound such as those made by cats. The sound expresses contentment. + + + Roaring + Loud, deep, or harsh prolonged sounds such as those made by big cats and bears for long-distance communication and intimidation. + + + Squawking + Loud, harsh noises such as those made by geese. + + + + Named-object-sound + A sound identifiable as coming from a particular type of object. + + Alarm-sound + A loud signal often loud continuous ringing to alert people to a problem or condition that requires urgent attention. + + + Beep + A short, single tone, that is typically high-pitched and generally made by a computer or other machine. + + + Buzz + A persistent vibratory sound often made by a buzzer device and used to indicate something incorrect. + + + Click + The sound made by a mechanical cash register, often to designate a reward. + + + Ding + A short ringing sound such as that made by a bell, often to indicate a correct response or the expiration of time. + + + Horn-blow + A loud sound made by forcing air through a sound device that funnels air to create the sound, often used to sound an alert. + + + Ka-ching + The sound made by a mechanical cash register, often to designate a reward. + + + Siren + A loud, continuous sound often varying in frequency designed to indicate an emergency. + + + + + + E-extensionallowed + + extensionAllowed + + + inLibrary + testlib + + + SubnodeE1 + + inLibrary + testlib + + + + SubnodeE2 + + inLibrary + testlib + + + + SubnodeE3 + + inLibrary + testlib + + + + + Property + Something that pertains to a thing. A characteristic of some entity. A quality or feature regarded as a characteristic or inherent part of someone or something. HED attributes are adjectives or adverbs. + + extensionAllowed + + + Agent-property + Something that pertains to an agent. + + extensionAllowed + + + Agent-state + The state of the agent. + + Agent-cognitive-state + The state of the cognitive processes or state of mind of the agent. + + Alert + Condition of heightened watchfulness or preparation for action. + + + Anesthetized + Having lost sensation to pain or having senses dulled due to the effects of an anesthetic. + + + Asleep + Having entered a periodic, readily reversible state of reduced awareness and metabolic activity, usually accompanied by physical relaxation and brain activity. + + + Attentive + Concentrating and focusing mental energy on the task or surroundings. + + + Awake + In a non sleeping state. + + + Brain-dead + Characterized by the irreversible absence of cortical and brain stem functioning. + + + Comatose + In a state of profound unconsciousness associated with markedly depressed cerebral activity. + + + Distracted + Lacking in concentration because of being preoccupied. + + + Drowsy + In a state of near-sleep, a strong desire for sleep, or sleeping for unusually long periods. + + + Intoxicated + In a state with disturbed psychophysiological functions and responses as a result of administration or ingestion of a psychoactive substance. + + + Locked-in + In a state of complete paralysis of all voluntary muscles except for the ones that control the movements of the eyes. + + + Passive + Not responding or initiating an action in response to a stimulus. + + + Resting + A state in which the agent is not exhibiting any physical exertion. + + + Vegetative + A state of wakefulness and conscience, but (in contrast to coma) with involuntary opening of the eyes and movements (such as teeth grinding, yawning, or thrashing of the extremities). + + + + Agent-emotional-state + The status of the general temperament and outlook of an agent. + + Angry + Experiencing emotions characterized by marked annoyance or hostility. + + + Aroused + In a state reactive to stimuli leading to increased heart rate and blood pressure, sensory alertness, mobility and readiness to respond. + + + Awed + Filled with wonder. Feeling grand, sublime or powerful emotions characterized by a combination of joy, fear, admiration, reverence, and/or respect. + + + Compassionate + Feeling or showing sympathy and concern for others often evoked for a person who is in distress and associated with altruistic motivation. + + + Content + Feeling satisfaction with things as they are. + + + Disgusted + Feeling revulsion or profound disapproval aroused by something unpleasant or offensive. + + + Emotionally-neutral + Feeling neither satisfied nor dissatisfied. + + + Empathetic + Understanding and sharing the feelings of another. Being aware of, being sensitive to, and vicariously experiencing the feelings, thoughts, and experience of another. + + + Excited + Feeling great enthusiasm and eagerness. + + + Fearful + Feeling apprehension that one may be in danger. + + + Frustrated + Feeling annoyed as a result of being blocked, thwarted, disappointed or defeated. + + + Grieving + Feeling sorrow in response to loss, whether physical or abstract. + + + Happy + Feeling pleased and content. + + + Jealous + Feeling threatened by a rival in a relationship with another individual, in particular an intimate partner, usually involves feelings of threat, fear, suspicion, distrust, anxiety, anger, betrayal, and rejection. + + + Joyful + Feeling delight or intense happiness. + + + Loving + Feeling a strong positive emotion of affection and attraction. + + + Relieved + No longer feeling pain, distress, anxiety, or reassured. + + + Sad + Feeling grief or unhappiness. + + + Stressed + Experiencing mental or emotional strain or tension. + + + + Agent-physiological-state + Having to do with the mechanical, physical, or biochemical function of an agent. + + Healthy + Having no significant health-related issues. + + relatedTag + Sick + + + + Hungry + Being in a state of craving or desiring food. + + relatedTag + Sated + Thirsty + + + + Rested + Feeling refreshed and relaxed. + + relatedTag + Tired + + + + Sated + Feeling full. + + relatedTag + Hungry + + + + Sick + Being in a state of ill health, bodily malfunction, or discomfort. + + relatedTag + Healthy + + + + Thirsty + Feeling a need to drink. + + relatedTag + Hungry + + + + Tired + Feeling in need of sleep or rest. + + relatedTag + Rested + + + + + Agent-postural-state + Pertaining to the position in which agent holds their body. + + Crouching + Adopting a position where the knees are bent and the upper body is brought forward and down, sometimes to avoid detection or to defend oneself. + + + Eyes-closed + Keeping eyes closed with no blinking. + + + Eyes-open + Keeping eyes open with occasional blinking. + + + Kneeling + Positioned where one or both knees are on the ground. + + + On-treadmill + Ambulation on an exercise apparatus with an endless moving belt to support moving in place. + + + Prone + Positioned in a recumbent body position whereby the person lies on its stomach and faces downward. + + + Seated-with-chin-rest + Using a device that supports the chin and head. + + + Sitting + In a seated position. + + + Standing + Assuming or maintaining an erect upright position. + + + + + Agent-task-role + The function or part that is ascribed to an agent in performing the task. + + Experiment-actor + An agent who plays a predetermined role to create the experiment scenario. + + + Experiment-controller + An agent exerting control over some aspect of the experiment. + + + Experiment-participant + Someone who takes part in an activity related to an experiment. + + + Experimenter + Person who is the owner of the experiment and has its responsibility. + + + + Agent-trait + A genetically, environmentally, or socially determined characteristic of an agent. + + Age + Length of time elapsed time since birth of the agent. + + # + + takesValue + + + valueClass + numericClass + + + + + Agent-experience-level + Amount of skill or knowledge that the agent has as pertains to the task. + + Expert-level + Having comprehensive and authoritative knowledge of or skill in a particular area related to the task. + + relatedTag + Intermediate-experience-level + Novice-level + + + + Intermediate-experience-level + Having a moderate amount of knowledge or skill related to the task. + + relatedTag + Expert-level + Novice-level + + + + Novice-level + Being inexperienced in a field or situation related to the task. + + relatedTag + Expert-level + Intermediate-experience-level + + + + + Ethnicity + Belong to a social group that has a common national or cultural tradition. Use with Label to avoid extension. + + + Gender + Characteristics that are socially constructed, including norms, behaviors, and roles based on sex. + + + Handedness + Individual preference for use of a hand, known as the dominant hand. + + Ambidextrous + Having no overall dominance in the use of right or left hand or foot in the performance of tasks that require one hand or foot. + + + Left-handed + Preference for using the left hand or foot for tasks requiring the use of a single hand or foot. + + + Right-handed + Preference for using the right hand or foot for tasks requiring the use of a single hand or foot. + + + + Race + Belonging to a group sharing physical or social qualities as defined within a specified society. Use with Label to avoid extension. + + + Sex + Physical properties or qualities by which male is distinguished from female. + + Female + Biological sex of an individual with female sexual organs such ova. + + + Intersex + Having genitalia and/or secondary sexual characteristics of indeterminate sex. + + + Male + Biological sex of an individual with male sexual organs producing sperm. + + + + + + Data-property + Something that pertains to data or information. + + extensionAllowed + + + Data-marker + An indicator placed to mark something. + + Data-break-marker + An indicator place to indicate a gap in the data. + + + Temporal-marker + An indicator placed at a particular time in the data. + + Inset + Marks an intermediate point in an ongoing event of temporal extent. + + topLevelTagGroup + + + reserved + + + relatedTag + Onset + Offset + + + + Offset + Marks the end of an event of temporal extent. + + topLevelTagGroup + + + reserved + + + relatedTag + Onset + Inset + + + + Onset + Marks the start of an ongoing event of temporal extent. + + topLevelTagGroup + + + reserved + + + relatedTag + Inset + Offset + + + + Pause + Indicates the temporary interruption of the operation a process and subsequently wait for a signal to continue. + + + Time-out + A cancellation or cessation that automatically occurs when a predefined interval of time has passed without a certain event occurring. + + + Time-sync + A synchronization signal whose purpose to help synchronize different signals or processes. Often used to indicate a marker inserted into the recorded data to allow post hoc synchronization of concurrently recorded data streams. + + + + + Data-resolution + Smallest change in a quality being measured by an sensor that causes a perceptible change. + + Printer-resolution + Resolution of a printer, usually expressed as the number of dots-per-inch for a printer. + + # + + takesValue + + + valueClass + numericClass + + + + + Screen-resolution + Resolution of a screen, usually expressed as the of pixels in a dimension for a digital display device. + + # + + takesValue + + + valueClass + numericClass + + + + + Sensory-resolution + Resolution of measurements by a sensing device. + + # + + takesValue + + + valueClass + numericClass + + + + + Spatial-resolution + Linear spacing of a spatial measurement. + + # + + takesValue + + + valueClass + numericClass + + + + + Spectral-resolution + Measures the ability of a sensor to resolve features in the electromagnetic spectrum. + + # + + takesValue + + + valueClass + numericClass + + + + + Temporal-resolution + Measures the ability of a sensor to resolve features in time. + + # + + takesValue + + + valueClass + numericClass + + + + + + Data-source-type + The type of place, person, or thing from which the data comes or can be obtained. + + Computed-feature + A feature computed from the data by a tool. This tag should be grouped with a label of the form Toolname_propertyName. + + + Computed-prediction + A computed extrapolation of known data. + + + Expert-annotation + An explanatory or critical comment or other in-context information provided by an authority. + + + Instrument-measurement + Information obtained from a device that is used to measure material properties or make other observations. + + + Observation + Active acquisition of information from a primary source. Should be grouped with a label of the form AgentID_featureName. + + + + Data-value + Designation of the type of a data item. + + Categorical-value + Indicates that something can take on a limited and usually fixed number of possible values. + + Categorical-class-value + Categorical values that fall into discrete classes such as true or false. The grouping is absolute in the sense that it is the same for all participants. + + All + To a complete degree or to the full or entire extent. + + relatedTag + Some + None + + + + Correct + Free from error. Especially conforming to fact or truth. + + relatedTag + Wrong + + + + Explicit + Stated clearly and in detail, leaving no room for confusion or doubt. + + relatedTag + Implicit + + + + False + Not in accordance with facts, reality or definitive criteria. + + relatedTag + True + + + + Implicit + Implied though not plainly expressed. + + relatedTag + Explicit + + + + Invalid + Not allowed or not conforming to the correct format or specifications. + + relatedTag + Valid + + + + None + No person or thing, nobody, not any. + + relatedTag + All + Some + + + + Some + At least a small amount or number of, but not a large amount of, or often. + + relatedTag + All + None + + + + True + Conforming to facts, reality or definitive criteria. + + relatedTag + False + + + + Valid + Allowable, usable, or acceptable. + + relatedTag + Invalid + + + + Wrong + Inaccurate or not correct. + + relatedTag + Correct + + + + + Categorical-judgment-value + Categorical values that are based on the judgment or perception of the participant such familiar and famous. + + Abnormal + Deviating in any way from the state, position, structure, condition, behavior, or rule which is considered a norm. + + relatedTag + Normal + + + + Asymmetrical + Lacking symmetry or having parts that fail to correspond to one another in shape, size, or arrangement. + + relatedTag + Symmetrical + + + + Audible + A sound that can be perceived by the participant. + + relatedTag + Inaudible + + + + Complex + Hard, involved or complicated, elaborate, having many parts. + + relatedTag + Simple + + + + Congruent + Concordance of multiple evidence lines. In agreement or harmony. + + relatedTag + Incongruent + + + + Constrained + Keeping something within particular limits or bounds. + + relatedTag + Unconstrained + + + + Disordered + Not neatly arranged. Confused and untidy. A structural quality in which the parts of an object are non-rigid. + + relatedTag + Ordered + + + + Familiar + Recognized, familiar, or within the scope of knowledge. + + relatedTag + Unfamiliar + Famous + + + + Famous + A person who has a high degree of recognition by the general population for his or her success or accomplishments. A famous person. + + relatedTag + Familiar + Unfamiliar + + + + Inaudible + A sound below the threshold of perception of the participant. + + relatedTag + Audible + + + + Incongruent + Not in agreement or harmony. + + relatedTag + Congruent + + + + Involuntary + An action that is not made by choice. In the body, involuntary actions (such as blushing) occur automatically, and cannot be controlled by choice. + + relatedTag + Voluntary + + + + Masked + Information exists but is not provided or is partially obscured due to security, privacy, or other concerns. + + relatedTag + Unmasked + + + + Normal + Being approximately average or within certain limits. Conforming with or constituting a norm or standard or level or type or social norm. + + relatedTag + Abnormal + + + + Ordered + Conforming to a logical or comprehensible arrangement of separate elements. + + relatedTag + Disordered + + + + Simple + Easily understood or presenting no difficulties. + + relatedTag + Complex + + + + Symmetrical + Made up of exactly similar parts facing each other or around an axis. Showing aspects of symmetry. + + relatedTag + Asymmetrical + + + + Unconstrained + Moving without restriction. + + relatedTag + Constrained + + + + Unfamiliar + Not having knowledge or experience of. + + relatedTag + Familiar + Famous + + + + Unmasked + Information is revealed. + + relatedTag + Masked + + + + Voluntary + Using free will or design; not forced or compelled; controlled by individual volition. + + relatedTag + Involuntary + + + + + Categorical-level-value + Categorical values based on dividing a continuous variable into levels such as high and low. + + Cold + Having an absence of heat. + + relatedTag + Hot + + + + Deep + Extending relatively far inward or downward. + + relatedTag + Shallow + + + + High + Having a greater than normal degree, intensity, or amount. + + relatedTag + Low + Medium + + + + Hot + Having an excess of heat. + + relatedTag + Cold + + + + Large + Having a great extent such as in physical dimensions, period of time, amplitude or frequency. + + relatedTag + Small + + + + Liminal + Situated at a sensory threshold that is barely perceptible or capable of eliciting a response. + + relatedTag + Subliminal + Supraliminal + + + + Loud + Having a perceived high intensity of sound. + + relatedTag + Quiet + + + + Low + Less than normal in degree, intensity or amount. + + relatedTag + High + + + + Medium + Mid-way between small and large in number, quantity, magnitude or extent. + + relatedTag + Low + High + + + + Negative + Involving disadvantage or harm. + + relatedTag + Positive + + + + Positive + Involving advantage or good. + + relatedTag + Negative + + + + Quiet + Characterizing a perceived low intensity of sound. + + relatedTag + Loud + + + + Rough + Having a surface with perceptible bumps, ridges, or irregularities. + + relatedTag + Smooth + + + + Shallow + Having a depth which is relatively low. + + relatedTag + Deep + + + + Small + Having a small extent such as in physical dimensions, period of time, amplitude or frequency. + + relatedTag + Large + + + + Smooth + Having a surface free from bumps, ridges, or irregularities. + + relatedTag + Rough + + + + Subliminal + Situated below a sensory threshold that is imperceptible or not capable of eliciting a response. + + relatedTag + Liminal + Supraliminal + + + + Supraliminal + Situated above a sensory threshold that is perceptible or capable of eliciting a response. + + relatedTag + Liminal + Subliminal + + + + Thick + Wide in width, extent or cross-section. + + relatedTag + Thin + + + + Thin + Narrow in width, extent or cross-section. + + relatedTag + Thick + + + + + Categorical-orientation-value + Value indicating the orientation or direction of something. + + Backward + Directed behind or to the rear. + + relatedTag + Forward + + + + Downward + Moving or leading toward a lower place or level. + + relatedTag + Leftward + Rightward + Upward + + + + Forward + At or near or directed toward the front. + + relatedTag + Backward + + + + Horizontally-oriented + Oriented parallel to or in the plane of the horizon. + + relatedTag + Vertically-oriented + + + + Leftward + Going toward or facing the left. + + relatedTag + Downward + Rightward + Upward + + + + Oblique + Slanting or inclined in direction, course, or position that is neither parallel nor perpendicular nor right-angular. + + relatedTag + Rotated + + + + Rightward + Going toward or situated on the right. + + relatedTag + Downward + Leftward + Upward + + + + Rotated + Positioned offset around an axis or center. + + + Upward + Moving, pointing, or leading to a higher place, point, or level. + + relatedTag + Downward + Leftward + Rightward + + + + Vertically-oriented + Oriented perpendicular to the plane of the horizon. + + relatedTag + Horizontally-oriented + + + + + + Physical-value + The value of some physical property of something. + + Temperature + A measure of hot or cold based on the average kinetic energy of the atoms or molecules in the system. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + temperatureUnits + + + + + Weight + The relative mass or the quantity of matter contained by something. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + weightUnits + + + + + + Quantitative-value + Something capable of being estimated or expressed with numeric values. + + Fraction + A numerical value between 0 and 1. + + # + + takesValue + + + valueClass + numericClass + + + + + Item-count + The integer count of something which is usually grouped with the entity it is counting. (Item-count/3, A) indicates that 3 of A have occurred up to this point. + + # + + takesValue + + + valueClass + numericClass + + + + + Item-index + The index of an item in a collection, sequence or other structure. (A (Item-index/3, B)) means that A is item number 3 in B. + + # + + takesValue + + + valueClass + numericClass + + + + + Item-interval + An integer indicating how many items or entities have passed since the last one of these. An item interval of 0 indicates the current item. + + # + + takesValue + + + valueClass + numericClass + + + + + Percentage + A fraction or ratio with 100 understood as the denominator. + + # + + takesValue + + + valueClass + numericClass + + + + + Ratio + A quotient of quantities of the same kind for different components within the same system. + + # + + takesValue + + + valueClass + numericClass + + + + + + Spatiotemporal-value + A property relating to space and/or time. + + Rate-of-change + The amount of change accumulated per unit time. + + Acceleration + Magnitude of the rate of change in either speed or direction. The direction of change should be given separately. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + accelerationUnits + + + + + Frequency + Frequency is the number of occurrences of a repeating event per unit time. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + frequencyUnits + + + + + Jerk-rate + Magnitude of the rate at which the acceleration of an object changes with respect to time. The direction of change should be given separately. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + jerkUnits + + + + + Refresh-rate + The frequency with which the image on a computer monitor or similar electronic display screen is refreshed, usually expressed in hertz. + + # + + takesValue + + + valueClass + numericClass + + + + + Sampling-rate + The number of digital samples taken or recorded per unit of time. + + # + + takesValue + + + unitClass + frequencyUnits + + + + + Speed + A scalar measure of the rate of movement of the object expressed either as the distance travelled divided by the time taken (average speed) or the rate of change of position with respect to time at a particular point (instantaneous speed). The direction of change should be given separately. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + speedUnits + + + + + Temporal-rate + The number of items per unit of time. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + frequencyUnits + + + + + + Spatial-value + Value of an item involving space. + + Angle + The amount of inclination of one line to another or the plane of one object to another. + + # + + takesValue + + + unitClass + angleUnits + + + valueClass + numericClass + + + + + Distance + A measure of the space separating two objects or points. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + physicalLengthUnits + + + + + Position + A reference to the alignment of an object, a particular situation or view of a situation, or the location of an object. Coordinates with respect a specified frame of reference or the default Screen-frame if no frame is given. + + X-position + The position along the x-axis of the frame of reference. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + physicalLengthUnits + + + + + Y-position + The position along the y-axis of the frame of reference. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + physicalLengthUnits + + + + + Z-position + The position along the z-axis of the frame of reference. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + physicalLengthUnits + + + + + + Size + The physical magnitude of something. + + Area + The extent of a 2-dimensional surface enclosed within a boundary. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + areaUnits + + + + + Depth + The distance from the surface of something especially from the perspective of looking from the front. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + physicalLengthUnits + + + + + Height + The vertical measurement or distance from the base to the top of an object. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + physicalLengthUnits + + + + + Length + The linear extent in space from one end of something to the other end, or the extent of something from beginning to end. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + physicalLengthUnits + + + + + Volume + The amount of three dimensional space occupied by an object or the capacity of a space or container. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + volumeUnits + + + + + Width + The extent or measurement of something from side to side. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + physicalLengthUnits + + + + + + + Temporal-value + A characteristic of or relating to time or limited by time. + + Delay + The time at which an event start time is delayed from the current onset time. This tag defines the start time of an event of temporal extent and may be used with the Duration tag. + + topLevelTagGroup + + + reserved + + + relatedTag + Duration + + + # + + takesValue + + + valueClass + numericClass + + + unitClass + timeUnits + + + + + Duration + The period of time during which an event occurs. This tag defines the end time of an event of temporal extent and may be used with the Delay tag. + + topLevelTagGroup + + + reserved + + + relatedTag + Delay + + + # + + takesValue + + + valueClass + numericClass + + + unitClass + timeUnits + + + + + Time-interval + The period of time separating two instances, events, or occurrences. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + timeUnits + + + + + Time-value + A value with units of time. Usually grouped with tags identifying what the value represents. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + timeUnits + + + + + + + Statistical-value + A value based on or employing the principles of statistics. + + extensionAllowed + + + Data-maximum + The largest possible quantity or degree. + + # + + takesValue + + + valueClass + numericClass + + + + + Data-mean + The sum of a set of values divided by the number of values in the set. + + # + + takesValue + + + valueClass + numericClass + + + + + Data-median + The value which has an equal number of values greater and less than it. + + # + + takesValue + + + valueClass + numericClass + + + + + Data-minimum + The smallest possible quantity. + + # + + takesValue + + + valueClass + numericClass + + + + + Probability + A measure of the expectation of the occurrence of a particular event. + + # + + takesValue + + + valueClass + numericClass + + + + + Standard-deviation + A measure of the range of values in a set of numbers. Standard deviation is a statistic used as a measure of the dispersion or variation in a distribution, equal to the square root of the arithmetic mean of the squares of the deviations from the arithmetic mean. + + # + + takesValue + + + valueClass + numericClass + + + + + Statistical-accuracy + A measure of closeness to true value expressed as a number between 0 and 1. + + # + + takesValue + + + valueClass + numericClass + + + + + Statistical-precision + A quantitative representation of the degree of accuracy necessary for or associated with a particular action. + + # + + takesValue + + + valueClass + numericClass + + + + + Statistical-recall + Sensitivity is a measurement datum qualifying a binary classification test and is computed by substracting the false negative rate to the integral numeral 1. + + # + + takesValue + + + valueClass + numericClass + + + + + Statistical-uncertainty + A measure of the inherent variability of repeated observation measurements of a quantity including quantities evaluated by statistical methods and by other means. + + # + + takesValue + + + valueClass + numericClass + + + + + + + Data-variability-attribute + An attribute describing how something changes or varies. + + Abrupt + Marked by sudden change. + + + Constant + Continually recurring or continuing without interruption. Not changing in time or space. + + + Continuous + Uninterrupted in time, sequence, substance, or extent. + + relatedTag + Discrete + Discontinuous + + + + Decreasing + Becoming smaller or fewer in size, amount, intensity, or degree. + + relatedTag + Increasing + + + + Deterministic + No randomness is involved in the development of the future states of the element. + + relatedTag + Random + Stochastic + + + + Discontinuous + Having a gap in time, sequence, substance, or extent. + + relatedTag + Continuous + + + + Discrete + Constituting a separate entities or parts. + + relatedTag + Continuous + Discontinuous + + + + Estimated-value + Something that has been calculated or measured approximately. + + + Exact-value + A value that is viewed to the true value according to some standard. + + + Flickering + Moving irregularly or unsteadily or burning or shining fitfully or with a fluctuating light. + + + Fractal + Having extremely irregular curves or shapes for which any suitably chosen part is similar in shape to a given larger or smaller part when magnified or reduced to the same size. + + + Increasing + Becoming greater in size, amount, or degree. + + relatedTag + Decreasing + + + + Random + Governed by or depending on chance. Lacking any definite plan or order or purpose. + + relatedTag + Deterministic + Stochastic + + + + Repetitive + A recurring action that is often non-purposeful. + + + Stochastic + Uses a random probability distribution or pattern that may be analysed statistically but may not be predicted precisely to determine future states. + + relatedTag + Deterministic + Random + + + + Varying + Differing in size, amount, degree, or nature. + + + + + Environmental-property + Relating to or arising from the surroundings of an agent. + + Augmented-reality + Using technology that enhances real-world experiences with computer-derived digital overlays to change some aspects of perception of the natural environment. The digital content is shown to the user through a smart device or glasses and responds to changes in the environment. + + + Indoors + Located inside a building or enclosure. + + + Motion-platform + A mechanism that creates the feelings of being in a real motion environment. + + + Outdoors + Any area outside a building or shelter. + + + Real-world + Located in a place that exists in real space and time under realistic conditions. + + + Rural + Of or pertaining to the country as opposed to the city. + + + Terrain + Characterization of the physical features of a tract of land. + + Composite-terrain + Tracts of land characterized by a mixure of physical features. + + + Dirt-terrain + Tracts of land characterized by a soil surface and lack of vegetation. + + + Grassy-terrain + Tracts of land covered by grass. + + + Gravel-terrain + Tracts of land covered by a surface consisting a loose aggregation of small water-worn or pounded stones. + + + Leaf-covered-terrain + Tracts of land covered by leaves and composited organic material. + + + Muddy-terrain + Tracts of land covered by a liquid or semi-liquid mixture of water and some combination of soil, silt, and clay. + + + Paved-terrain + Tracts of land covered with concrete, asphalt, stones, or bricks. + + + Rocky-terrain + Tracts of land consisting or full of rock or rocks. + + + Sloped-terrain + Tracts of land arranged in a sloping or inclined position. + + + Uneven-terrain + Tracts of land that are not level, smooth, or regular. + + + + Urban + Relating to, located in, or characteristic of a city or densely populated area. + + + Virtual-world + Using technology that creates immersive, computer-generated experiences that a person can interact with and navigate through. The digital content is generally delivered to the user through some type of headset and responds to changes in head position or through interaction with other types of sensors. Existing in a virtual setting such as a simulation or game environment. + + + + Informational-property + Something that pertains to a task. + + extensionAllowed + + + Description + An explanation of what the tag group it is in means. If the description is at the top-level of an event string, the description applies to the event. + + requireChild + + + # + + takesValue + + + valueClass + textClass + + + + + ID + An alphanumeric name that identifies either a unique object or a unique class of objects. Here the object or class may be an idea, physical countable object (or class), or physical uncountable substance (or class). + + requireChild + + + # + + takesValue + + + valueClass + textClass + + + + + Label + A string of 20 or fewer characters identifying something. Labels usually refer to general classes of things while IDs refer to specific instances. A term that is associated with some entity. A brief description given for purposes of identification. An identifying or descriptive marker that is attached to an object. + + requireChild + + + # + + takesValue + + + valueClass + nameClass + + + + + Metadata + Data about data. Information that describes another set of data. + + CogAtlas + The Cognitive Atlas ID number of something. + + # + + takesValue + + + + + CogPo + The CogPO ID number of something. + + # + + takesValue + + + + + Creation-date + The date on which data creation of this element began. + + requireChild + + + # + + takesValue + + + valueClass + dateTimeClass + + + + + Experimental-note + A brief written record about the experiment. + + # + + takesValue + + + valueClass + textClass + + + + + Library-name + Official name of a HED library. + + # + + takesValue + + + valueClass + nameClass + + + + + OBO-identifier + The identifier of a term in some Open Biology Ontology (OBO) ontology. + + # + + takesValue + + + valueClass + nameClass + + + + + Pathname + The specification of a node (file or directory) in a hierarchical file system, usually specified by listing the nodes top-down. + + # + + takesValue + + + + + Subject-identifier + A sequence of characters used to identify, name, or characterize a trial or study subject. + + # + + takesValue + + + + + Version-identifier + An alphanumeric character string that identifies a form or variant of a type or original. + + # + Usually is a semantic version. + + takesValue + + + + + + Parameter + Something user-defined for this experiment. + + Parameter-label + The name of the parameter. + + # + + takesValue + + + valueClass + nameClass + + + + + Parameter-value + The value of the parameter. + + # + + takesValue + + + valueClass + textClass + + + + + + + Organizational-property + Relating to an organization or the action of organizing something. + + Collection + A tag designating a grouping of items such as in a set or list. + + # + Name of the collection. + + takesValue + + + valueClass + nameClass + + + + + Condition-variable + An aspect of the experiment or task that is to be varied during the experiment. Task-conditions are sometimes called independent variables or contrasts. + + # + Name of the condition variable. + + takesValue + + + valueClass + nameClass + + + + + Control-variable + An aspect of the experiment that is fixed throughout the study and usually is explicitly controlled. + + # + Name of the control variable. + + takesValue + + + valueClass + nameClass + + + + + Def + A HED-specific utility tag used with a defined name to represent the tags associated with that definition. + + requireChild + + + reserved + + + # + Name of the definition. + + takesValue + + + valueClass + nameClass + + + + + Def-expand + A HED specific utility tag that is grouped with an expanded definition. The child value of the Def-expand is the name of the expanded definition. + + requireChild + + + reserved + + + tagGroup + + + # + + takesValue + + + valueClass + nameClass + + + + + Definition + A HED-specific utility tag whose child value is the name of the concept and the tag group associated with the tag is an English language explanation of a concept. + + requireChild + + + reserved + + + topLevelTagGroup + + + # + Name of the definition. + + takesValue + + + valueClass + nameClass + + + + + Event-context + A special HED tag inserted as part of a top-level tag group to contain information about the interrelated conditions under which the event occurs. The event context includes information about other events that are ongoing when this event happens. + + reserved + + + topLevelTagGroup + + + unique + + + + Event-stream + A special HED tag indicating that this event is a member of an ordered succession of events. + + # + Name of the event stream. + + takesValue + + + valueClass + nameClass + + + + + Experimental-intertrial + A tag used to indicate a part of the experiment between trials usually where nothing is happening. + + # + Optional label for the intertrial block. + + takesValue + + + valueClass + nameClass + + + + + Experimental-trial + Designates a run or execution of an activity, for example, one execution of a script. A tag used to indicate a particular organizational part in the experimental design often containing a stimulus-response pair or stimulus-response-feedback triad. + + # + Optional label for the trial (often a numerical string). + + takesValue + + + valueClass + nameClass + + + + + Indicator-variable + An aspect of the experiment or task that is measured as task conditions are varied during the experiment. Experiment indicators are sometimes called dependent variables. + + # + Name of the indicator variable. + + takesValue + + + valueClass + nameClass + + + + + Recording + A tag designating the data recording. Recording tags are usually have temporal scope which is the entire recording. + + # + Optional label for the recording. + + takesValue + + + valueClass + nameClass + + + + + Task + An assigned piece of work, usually with a time allotment. A tag used to indicate a linkage the structured activities performed as part of the experiment. + + # + Optional label for the task block. + + takesValue + + + valueClass + nameClass + + + + + Time-block + A tag used to indicate a contiguous time block in the experiment during which something is fixed or noted. + + # + Optional label for the task block. + + takesValue + + + valueClass + nameClass + + + + + + Sensory-property + Relating to sensation or the physical senses. + + Sensory-attribute + A sensory characteristic associated with another entity. + + Auditory-attribute + Pertaining to the sense of hearing. + + Loudness + Perceived intensity of a sound. + + # + + takesValue + + + valueClass + numericClass + nameClass + + + + + Pitch + A perceptual property that allows the user to order sounds on a frequency scale. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + frequencyUnits + + + + + Sound-envelope + Description of how a sound changes over time. + + Sound-envelope-attack + The time taken for initial run-up of level from nil to peak usually beginning when the key on a musical instrument is pressed. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + timeUnits + + + + + Sound-envelope-decay + The time taken for the subsequent run down from the attack level to the designated sustain level. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + timeUnits + + + + + Sound-envelope-release + The time taken for the level to decay from the sustain level to zero after the key is released. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + timeUnits + + + + + Sound-envelope-sustain + The time taken for the main sequence of the sound duration, until the key is released. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + timeUnits + + + + + + Sound-volume + The sound pressure level (SPL) usually the ratio to a reference signal estimated as the lower bound of hearing. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + intensityUnits + + + + + Timbre + The perceived sound quality of a singing voice or musical instrument. + + # + + takesValue + + + valueClass + nameClass + + + + + + Gustatory-attribute + Pertaining to the sense of taste. + + Bitter + Having a sharp, pungent taste. + + + Salty + Tasting of or like salt. + + + Savory + Belonging to a taste that is salty or spicy rather than sweet. + + + Sour + Having a sharp, acidic taste. + + + Sweet + Having or resembling the taste of sugar. + + + + Olfactory-attribute + Having a smell. + + + Somatic-attribute + Pertaining to the feelings in the body or of the nervous system. + + Pain + The sensation of discomfort, distress, or agony, resulting from the stimulation of specialized nerve endings. + + + Stress + The negative mental, emotional, and physical reactions that occur when environmental stressors are perceived as exceeding the adaptive capacities of the individual. + + + + Tactile-attribute + Pertaining to the sense of touch. + + Tactile-pressure + Having a feeling of heaviness. + + + Tactile-temperature + Having a feeling of hotness or coldness. + + + Tactile-texture + Having a feeling of roughness. + + + Tactile-vibration + Having a feeling of mechanical oscillation. + + + + Vestibular-attribute + Pertaining to the sense of balance or body position. + + + Visual-attribute + Pertaining to the sense of sight. + + Color + The appearance of objects (or light sources) described in terms of perception of their hue and lightness (or brightness) and saturation. + + CSS-color + One of 140 colors supported by all browsers. For more details such as the color RGB or HEX values, check: https://www.w3schools.com/colors/colors_groups.asp. + + Blue-color + CSS color group. + + Blue + CSS-color 0x0000FF. + + + CadetBlue + CSS-color 0x5F9EA0. + + + CornflowerBlue + CSS-color 0x6495ED. + + + DarkBlue + CSS-color 0x00008B. + + + DeepSkyBlue + CSS-color 0x00BFFF. + + + DodgerBlue + CSS-color 0x1E90FF. + + + LightBlue + CSS-color 0xADD8E6. + + + LightSkyBlue + CSS-color 0x87CEFA. + + + LightSteelBlue + CSS-color 0xB0C4DE. + + + MediumBlue + CSS-color 0x0000CD. + + + MidnightBlue + CSS-color 0x191970. + + + Navy + CSS-color 0x000080. + + + PowderBlue + CSS-color 0xB0E0E6. + + + RoyalBlue + CSS-color 0x4169E1. + + + SkyBlue + CSS-color 0x87CEEB. + + + SteelBlue + CSS-color 0x4682B4. + + + + Brown-color + CSS color group. + + Bisque + CSS-color 0xFFE4C4. + + + BlanchedAlmond + CSS-color 0xFFEBCD. + + + Brown + CSS-color 0xA52A2A. + + + BurlyWood + CSS-color 0xDEB887. + + + Chocolate + CSS-color 0xD2691E. + + + Cornsilk + CSS-color 0xFFF8DC. + + + DarkGoldenRod + CSS-color 0xB8860B. + + + GoldenRod + CSS-color 0xDAA520. + + + Maroon + CSS-color 0x800000. + + + NavajoWhite + CSS-color 0xFFDEAD. + + + Olive + CSS-color 0x808000. + + + Peru + CSS-color 0xCD853F. + + + RosyBrown + CSS-color 0xBC8F8F. + + + SaddleBrown + CSS-color 0x8B4513. + + + SandyBrown + CSS-color 0xF4A460. + + + Sienna + CSS-color 0xA0522D. + + + Tan + CSS-color 0xD2B48C. + + + Wheat + CSS-color 0xF5DEB3. + + + + Cyan-color + CSS color group. + + Aqua + CSS-color 0x00FFFF. + + + Aquamarine + CSS-color 0x7FFFD4. + + + Cyan + CSS-color 0x00FFFF. + + + DarkTurquoise + CSS-color 0x00CED1. + + + LightCyan + CSS-color 0xE0FFFF. + + + MediumTurquoise + CSS-color 0x48D1CC. + + + PaleTurquoise + CSS-color 0xAFEEEE. + + + Turquoise + CSS-color 0x40E0D0. + + + + Gray-color + CSS color group. + + Black + CSS-color 0x000000. + + + DarkGray + CSS-color 0xA9A9A9. + + + DarkSlateGray + CSS-color 0x2F4F4F. + + + DimGray + CSS-color 0x696969. + + + Gainsboro + CSS-color 0xDCDCDC. + + + Gray + CSS-color 0x808080. + + + LightGray + CSS-color 0xD3D3D3. + + + LightSlateGray + CSS-color 0x778899. + + + Silver + CSS-color 0xC0C0C0. + + + SlateGray + CSS-color 0x708090. + + + + Green-color + CSS color group. + + Chartreuse + CSS-color 0x7FFF00. + + + DarkCyan + CSS-color 0x008B8B. + + + DarkGreen + CSS-color 0x006400. + + + DarkOliveGreen + CSS-color 0x556B2F. + + + DarkSeaGreen + CSS-color 0x8FBC8F. + + + ForestGreen + CSS-color 0x228B22. + + + Green + CSS-color 0x008000. + + + GreenYellow + CSS-color 0xADFF2F. + + + LawnGreen + CSS-color 0x7CFC00. + + + LightGreen + CSS-color 0x90EE90. + + + LightSeaGreen + CSS-color 0x20B2AA. + + + Lime + CSS-color 0x00FF00. + + + LimeGreen + CSS-color 0x32CD32. + + + MediumAquaMarine + CSS-color 0x66CDAA. + + + MediumSeaGreen + CSS-color 0x3CB371. + + + MediumSpringGreen + CSS-color 0x00FA9A. + + + OliveDrab + CSS-color 0x6B8E23. + + + PaleGreen + CSS-color 0x98FB98. + + + SeaGreen + CSS-color 0x2E8B57. + + + SpringGreen + CSS-color 0x00FF7F. + + + Teal + CSS-color 0x008080. + + + YellowGreen + CSS-color 0x9ACD32. + + + + Orange-color + CSS color group. + + Coral + CSS-color 0xFF7F50. + + + DarkOrange + CSS-color 0xFF8C00. + + + Orange + CSS-color 0xFFA500. + + + OrangeRed + CSS-color 0xFF4500. + + + Tomato + CSS-color 0xFF6347. + + + + Pink-color + CSS color group. + + DeepPink + CSS-color 0xFF1493. + + + HotPink + CSS-color 0xFF69B4. + + + LightPink + CSS-color 0xFFB6C1. + + + MediumVioletRed + CSS-color 0xC71585. + + + PaleVioletRed + CSS-color 0xDB7093. + + + Pink + CSS-color 0xFFC0CB. + + + + Purple-color + CSS color group. + + BlueViolet + CSS-color 0x8A2BE2. + + + DarkMagenta + CSS-color 0x8B008B. + + + DarkOrchid + CSS-color 0x9932CC. + + + DarkSlateBlue + CSS-color 0x483D8B. + + + DarkViolet + CSS-color 0x9400D3. + + + Fuchsia + CSS-color 0xFF00FF. + + + Indigo + CSS-color 0x4B0082. + + + Lavender + CSS-color 0xE6E6FA. + + + Magenta + CSS-color 0xFF00FF. + + + MediumOrchid + CSS-color 0xBA55D3. + + + MediumPurple + CSS-color 0x9370DB. + + + MediumSlateBlue + CSS-color 0x7B68EE. + + + Orchid + CSS-color 0xDA70D6. + + + Plum + CSS-color 0xDDA0DD. + + + Purple + CSS-color 0x800080. + + + RebeccaPurple + CSS-color 0x663399. + + + SlateBlue + CSS-color 0x6A5ACD. + + + Thistle + CSS-color 0xD8BFD8. + + + Violet + CSS-color 0xEE82EE. + + + + Red-color + CSS color group. + + Crimson + CSS-color 0xDC143C. + + + DarkRed + CSS-color 0x8B0000. + + + DarkSalmon + CSS-color 0xE9967A. + + + FireBrick + CSS-color 0xB22222. + + + IndianRed + CSS-color 0xCD5C5C. + + + LightCoral + CSS-color 0xF08080. + + + LightSalmon + CSS-color 0xFFA07A. + + + Red + CSS-color 0xFF0000. + + + Salmon + CSS-color 0xFA8072. + + + + White-color + CSS color group. + + AliceBlue + CSS-color 0xF0F8FF. + + + AntiqueWhite + CSS-color 0xFAEBD7. + + + Azure + CSS-color 0xF0FFFF. + + + Beige + CSS-color 0xF5F5DC. + + + FloralWhite + CSS-color 0xFFFAF0. + + + GhostWhite + CSS-color 0xF8F8FF. + + + HoneyDew + CSS-color 0xF0FFF0. + + + Ivory + CSS-color 0xFFFFF0. + + + LavenderBlush + CSS-color 0xFFF0F5. + + + Linen + CSS-color 0xFAF0E6. + + + MintCream + CSS-color 0xF5FFFA. + + + MistyRose + CSS-color 0xFFE4E1. + + + OldLace + CSS-color 0xFDF5E6. + + + SeaShell + CSS-color 0xFFF5EE. + + + Snow + CSS-color 0xFFFAFA. + + + White + CSS-color 0xFFFFFF. + + + WhiteSmoke + CSS-color 0xF5F5F5. + + + + Yellow-color + CSS color group. + + DarkKhaki + CSS-color 0xBDB76B. + + + Gold + CSS-color 0xFFD700. + + + Khaki + CSS-color 0xF0E68C. + + + LemonChiffon + CSS-color 0xFFFACD. + + + LightGoldenRodYellow + CSS-color 0xFAFAD2. + + + LightYellow + CSS-color 0xFFFFE0. + + + Moccasin + CSS-color 0xFFE4B5. + + + PaleGoldenRod + CSS-color 0xEEE8AA. + + + PapayaWhip + CSS-color 0xFFEFD5. + + + PeachPuff + CSS-color 0xFFDAB9. + + + Yellow + CSS-color 0xFFFF00. + + + + + Color-shade + A slight degree of difference between colors, especially with regard to how light or dark it is or as distinguished from one nearly like it. + + Dark-shade + A color tone not reflecting much light. + + + Light-shade + A color tone reflecting more light. + + + + Grayscale + Using a color map composed of shades of gray, varying from black at the weakest intensity to white at the strongest. + + # + White intensity between 0 and 1. + + takesValue + + + valueClass + numericClass + + + + + HSV-color + A color representation that models how colors appear under light. + + HSV-value + An attribute of a visual sensation according to which an area appears to emit more or less light. + + # + + takesValue + + + valueClass + numericClass + + + + + Hue + Attribute of a visual sensation according to which an area appears to be similar to one of the perceived colors. + + # + Angular value between 0 and 360. + + takesValue + + + valueClass + numericClass + + + + + Saturation + Colorfulness of a stimulus relative to its own brightness. + + # + B value of RGB between 0 and 1. + + takesValue + + + valueClass + numericClass + + + + + + RGB-color + A color from the RGB schema. + + RGB-blue + The blue component. + + # + B value of RGB between 0 and 1. + + takesValue + + + valueClass + numericClass + + + + + RGB-green + The green component. + + # + G value of RGB between 0 and 1. + + takesValue + + + valueClass + numericClass + + + + + RGB-red + The red component. + + # + R value of RGB between 0 and 1. + + takesValue + + + valueClass + numericClass + + + + + + + Luminance + A quality that exists by virtue of the luminous intensity per unit area projected in a given direction. + + + Opacity + A measure of impenetrability to light. + + + + + Sensory-presentation + The entity has a sensory manifestation. + + Auditory-presentation + The sense of hearing is used in the presentation to the user. + + Loudspeaker-separation + The distance between two loudspeakers. Grouped with the Distance tag. + + suggestedTag + Distance + + + + Monophonic + Relating to sound transmission, recording, or reproduction involving a single transmission path. + + + Silent + The absence of ambient audible sound or the state of having ceased to produce sounds. + + + Stereophonic + Relating to, or constituting sound reproduction involving the use of separated microphones and two transmission channels to achieve the sound separation of a live hearing. + + + + Gustatory-presentation + The sense of taste used in the presentation to the user. + + + Olfactory-presentation + The sense of smell used in the presentation to the user. + + + Somatic-presentation + The nervous system is used in the presentation to the user. + + + Tactile-presentation + The sense of touch used in the presentation to the user. + + + Vestibular-presentation + The sense balance used in the presentation to the user. + + + Visual-presentation + The sense of sight used in the presentation to the user. + + 2D-view + A view showing only two dimensions. + + + 3D-view + A view showing three dimensions. + + + Background-view + Parts of the view that are farthest from the viewer and usually the not part of the visual focus. + + + Bistable-view + Something having two stable visual forms that have two distinguishable stable forms as in optical illusions. + + + Foreground-view + Parts of the view that are closest to the viewer and usually the most important part of the visual focus. + + + Foveal-view + Visual presentation directly on the fovea. A view projected on the small depression in the retina containing only cones and where vision is most acute. + + + Map-view + A diagrammatic representation of an area of land or sea showing physical features, cities, roads. + + Aerial-view + Elevated view of an object from above, with a perspective as though the observer were a bird. + + + Satellite-view + A representation as captured by technology such as a satellite. + + + Street-view + A 360-degrees panoramic view from a position on the ground. + + + + Peripheral-view + Indirect vision as it occurs outside the point of fixation. + + + + + + Task-property + Something that pertains to a task. + + extensionAllowed + + + Task-action-type + How an agent action should be interpreted in terms of the task specification. + + Appropriate-action + An action suitable or proper in the circumstances. + + relatedTag + Inappropriate-action + + + + Correct-action + An action that was a correct response in the context of the task. + + relatedTag + Incorrect-action + Indeterminate-action + + + + Correction + An action offering an improvement to replace a mistake or error. + + + Done-indication + An action that indicates that the participant has completed this step in the task. + + relatedTag + Ready-indication + + + + Imagined-action + Form a mental image or concept of something. This is used to identity something that only happened in the imagination of the participant as in imagined movements in motor imagery paradigms. + + + Inappropriate-action + An action not in keeping with what is correct or proper for the task. + + relatedTag + Appropriate-action + + + + Incorrect-action + An action considered wrong or incorrect in the context of the task. + + relatedTag + Correct-action + Indeterminate-action + + + + Indeterminate-action + An action that cannot be distinguished between two or more possibibities in the current context. This tag might be applied when an outside evaluator or a classification algorithm cannot determine a definitive result. + + relatedTag + Correct-action + Incorrect-action + Miss + Near-miss + + + + Miss + An action considered to be a failure in the context of the task. For example, if the agent is supposed to try to hit a target and misses. + + relatedTag + Near-miss + + + + Near-miss + An action barely satisfied the requirements of the task. In a driving experiment for example this could pertain to a narrowly avoided collision or other accident. + + relatedTag + Miss + + + + Omitted-action + An expected response was skipped. + + + Ready-indication + An action that indicates that the participant is ready to perform the next step in the task. + + relatedTag + Done-indication + + + + + Task-attentional-demand + Strategy for allocating attention toward goal-relevant information. + + Bottom-up-attention + Attentional guidance purely by externally driven factors to stimuli that are salient because of their inherent properties relative to the background. Sometimes this is referred to as stimulus driven. + + relatedTag + Top-down-attention + + + + Covert-attention + Paying attention without moving the eyes. + + relatedTag + Overt-attention + + + + Divided-attention + Integrating parallel multiple stimuli. Behavior involving responding simultaneously to multiple tasks or multiple task demands. + + relatedTag + Focused-attention + + + + Focused-attention + Responding discretely to specific visual, auditory, or tactile stimuli. + + relatedTag + Divided-attention + + + + Orienting-attention + Directing attention to a target stimulus. + + + Overt-attention + Selectively processing one location over others by moving the eyes to point at that location. + + relatedTag + Covert-attention + + + + Selective-attention + Maintaining a behavioral or cognitive set in the face of distracting or competing stimuli. Ability to pay attention to a limited array of all available sensory information. + + + Sustained-attention + Maintaining a consistent behavioral response during continuous and repetitive activity. + + + Switched-attention + Having to switch attention between two or more modalities of presentation. + + + Top-down-attention + Voluntary allocation of attention to certain features. Sometimes this is referred to goal-oriented attention. + + relatedTag + Bottom-up-attention + + + + + Task-effect-evidence + The evidence supporting the conclusion that the event had the specified effect. + + Behavioral-evidence + An indication or conclusion based on the behavior of an agent. + + + Computational-evidence + A type of evidence in which data are produced, and/or generated, and/or analyzed on a computer. + + + External-evidence + A phenomenon that follows and is caused by some previous phenomenon. + + + Intended-effect + A phenomenon that is intended to follow and be caused by some previous phenomenon. + + + + Task-event-role + The purpose of an event with respect to the task. + + Experimental-stimulus + Part of something designed to elicit a response in the experiment. + + + Incidental + A sensory or other type of event that is unrelated to the task or experiment. + + + Instructional + Usually associated with a sensory event intended to give instructions to the participant about the task or behavior. + + + Mishap + Unplanned disruption such as an equipment or experiment control abnormality or experimenter error. + + + Participant-response + Something related to a participant actions in performing the task. + + + Task-activity + Something that is part of the overall task or is necessary to the overall experiment but is not directly part of a stimulus-response cycle. Examples would be taking a survey or provided providing a silva sample. + + + Warning + Something that should warn the participant that the parameters of the task have been or are about to be exceeded such as a warning message about getting too close to the shoulder of the road in a driving task. + + + + Task-relationship + Specifying organizational importance of sub-tasks. + + Background-subtask + A part of the task which should be performed in the background as for example inhibiting blinks due to instruction while performing the primary task. + + + Primary-subtask + A part of the task which should be the primary focus of the participant. + + + + Task-stimulus-role + The role the stimulus plays in the task. + + Cue + A signal for an action, a pattern of stimuli indicating a particular response. + + + Distractor + A person or thing that distracts or a plausible but incorrect option in a multiple-choice question. In pyschological studies this is sometimes referred to as a foil. + + + Expected + Considered likely, probable or anticipated. Something of low information value as in frequent non-targets in an RSVP paradigm. + + relatedTag + Unexpected + + + suggestedTag + Target + + + + Extraneous + Irrelevant or unrelated to the subject being dealt with. + + + Feedback + An evaluative response to an inquiry, process, event, or activity. + + + Go-signal + An indicator to proceed with a planned action. + + relatedTag + Stop-signal + + + + Meaningful + Conveying significant or relevant information. + + + Newly-learned + Representing recently acquired information or understanding. + + + Non-informative + Something that is not useful in forming an opinion or judging an outcome. + + + Non-target + Something other than that done or looked for. Also tag Expected if the Non-target is frequent. + + relatedTag + Target + + + + Not-meaningful + Not having a serious, important, or useful quality or purpose. + + + Novel + Having no previous example or precedent or parallel. + + + Oddball + Something unusual, or infrequent. + + relatedTag + Unexpected + + + suggestedTag + Target + + + + Penalty + A disadvantage, loss, or hardship due to some action. + + + Planned + Something that was decided on or arranged in advance. + + relatedTag + Unplanned + + + + Priming + An implicit memory effect in which exposure to a stimulus influences response to a later stimulus. + + + Query + A sentence of inquiry that asks for a reply. + + + Reward + A positive reinforcement for a desired action, behavior or response. + + + Stop-signal + An indicator that the agent should stop the current activity. + + relatedTag + Go-signal + + + + Target + Something fixed as a goal, destination, or point of examination. + + + Threat + An indicator that signifies hostility and predicts an increased probability of attack. + + + Timed + Something planned or scheduled to be done at a particular time or lasting for a specified amount of time. + + + Unexpected + Something that is not anticipated. + + relatedTag + Expected + + + + Unplanned + Something that has not been planned as part of the task. + + relatedTag + Planned + + + + + + + Relation + Concerns the way in which two or more people or things are connected. + + extensionAllowed + + + Comparative-relation + Something considered in comparison to something else. The first entity is the focus. + + Approximately-equal-to + (A, (Approximately-equal-to, B)) indicates that A and B have almost the same value. Here A and B could refer to sizes, orders, positions or other quantities. + + + Equal-to + (A, (Equal-to, B)) indicates that the size or order of A is the same as that of B. + + + Greater-than + (A, (Greater-than, B)) indicates that the relative size or order of A is bigger than that of B. + + + Greater-than-or-equal-to + (A, (Greater-than-or-equal-to, B)) indicates that the relative size or order of A is bigger than or the same as that of B. + + + Less-than + (A, (Less-than, B)) indicates that A is smaller than B. Here A and B could refer to sizes, orders, positions or other quantities. + + + Less-than-or-equal-to + (A, (Less-than-or-equal-to, B)) indicates that the relative size or order of A is smaller than or equal to B. + + + Not-equal-to + (A, (Not-equal-to, B)) indicates that the size or order of A is not the same as that of B. + + + + Connective-relation + Indicates two entities are related in some way. The first entity is the focus. + + Belongs-to + (A, (Belongs-to, B)) indicates that A is a member of B. + + + Connected-to + (A, (Connected-to, B)) indicates that A is related to B in some respect, usually through a direct link. + + + Contained-in + (A, (Contained-in, B)) indicates that A is completely inside of B. + + + Described-by + (A, (Described-by, B)) indicates that B provides information about A. + + + From-to + (A, (From-to, B)) indicates a directional relation from A to B. A is considered the source. + + + Group-of + (A, (Group-of, B)) indicates A is a group of items of type B. + + + Implied-by + (A, (Implied-by, B)) indicates B is suggested by A. + + + Includes + (A, (Includes, B)) indicates that A has B as a member or part. + + + Interacts-with + (A, (Interacts-with, B)) indicates A and B interact, possibly reciprocally. + + + Member-of + (A, (Member-of, B)) indicates A is a member of group B. + + + Part-of + (A, (Part-of, B)) indicates A is a part of the whole B. + + + Performed-by + (A, (Performed-by, B)) indicates that the action or procedure A was carried out by agent B. + + + Performed-using + (A, (Performed-using, B)) indicates that the action or procedure A was accomplished using B. + + + Related-to + (A, (Related-to, B)) indicates A has some relationship to B. + + + Unrelated-to + (A, (Unrelated-to, B)) indicates that A is not related to B. For example, A is not related to Task. + + + + Directional-relation + A relationship indicating direction of change of one entity relative to another. The first entity is the focus. + + Away-from + (A, (Away-from, B)) indicates that A is going or has moved away from B. The meaning depends on A and B. + + + Towards + (A, (Towards, B)) indicates that A is going to or has moved to B. The meaning depends on A and B. + + + + Logical-relation + Indicating a logical relationship between entities. The first entity is usually the focus. + + And + (A, (And, B)) means A and B are both in effect. + + + Or + (A, (Or, B)) means at least one of A and B are in effect. + + + + Spatial-relation + Indicating a relationship about position between entities. + + Above + (A, (Above, B)) means A is in a place or position that is higher than B. + + + Across-from + (A, (Across-from, B)) means A is on the opposite side of something from B. + + + Adjacent-to + (A, (Adjacent-to, B)) indicates that A is next to B in time or space. + + + Ahead-of + (A, (Ahead-of, B)) indicates that A is further forward in time or space in B. + + + Around + (A, (Around, B)) means A is in or near the present place or situation of B. + + + Behind + (A, (Behind, B)) means A is at or to the far side of B, typically so as to be hidden by it. + + + Below + (A, (Below, B)) means A is in a place or position that is lower than the position of B. + + + Between + (A, (Between, (B, C))) means A is in the space or interval separating B and C. + + + Bilateral-to + (A, (Bilateral, B)) means A is on both sides of B or affects both sides of B. + + + Bottom-edge-of + (A, (Bottom-edge-of, B)) means A is on the bottom most part or or near the boundary of B. + + relatedTag + Left-edge-of + Right-edge-of + Top-edge-of + + + + Boundary-of + (A, (Boundary-of, B)) means A is on or part of the edge or boundary of B. + + + Center-of + (A, (Center-of, B)) means A is at a point or or in an area that is approximately central within B. + + + Close-to + (A, (Close-to, B)) means A is at a small distance from or is located near in space to B. + + + Far-from + (A, (Far-from, B)) means A is at a large distance from or is not located near in space to B. + + + In-front-of + (A, (In-front-of, B)) means A is in a position just ahead or at the front part of B, potentially partially blocking B from view. + + + Left-edge-of + (A, (Left-edge-of, B)) means A is located on the left side of B on or near the boundary of B. + + relatedTag + Bottom-edge-of + Right-edge-of + Top-edge-of + + + + Left-side-of + (A, (Left-side-of, B)) means A is located on the left side of B usually as part of B. + + relatedTag + Right-side-of + + + + Lower-center-of + (A, (Lower-center-of, B)) means A is situated on the lower center part of B (due south). This relation is often used to specify qualitative information about screen position. + + relatedTag + Center-of + Lower-left-of + Lower-right-of + Upper-center-of + Upper-right-of + + + + Lower-left-of + (A, (Lower-left-of, B)) means A is situated on the lower left part of B. This relation is often used to specify qualitative information about screen position. + + relatedTag + Center-of + Lower-center-of + Lower-right-of + Upper-center-of + Upper-left-of + Upper-right-of + + + + Lower-right-of + (A, (Lower-right-of, B)) means A is situated on the lower right part of B. This relation is often used to specify qualitative information about screen position. + + relatedTag + Center-of + Lower-center-of + Lower-left-of + Upper-left-of + Upper-center-of + Upper-left-of + Lower-right-of + + + + Outside-of + (A, (Outside-of, B)) means A is located in the space around but not including B. + + + Over + (A, (Over, B)) means A above is above B so as to cover or protect or A extends over the a general area as from a from a vantage point. + + + Right-edge-of + (A, (Right-edge-of, B)) means A is located on the right side of B on or near the boundary of B. + + relatedTag + Bottom-edge-of + Left-edge-of + Top-edge-of + + + + Right-side-of + (A, (Right-side-of, B)) means A is located on the right side of B usually as part of B. + + relatedTag + Left-side-of + + + + To-left-of + (A, (To-left-of, B)) means A is located on or directed toward the side to the west of B when B is facing north. This term is used when A is not part of B. + + + To-right-of + (A, (To-right-of, B)) means A is located on or directed toward the side to the east of B when B is facing north. This term is used when A is not part of B. + + + Top-edge-of + (A, (Top-edge-of, B)) means A is on the uppermost part or or near the boundary of B. + + relatedTag + Left-edge-of + Right-edge-of + Bottom-edge-of + + + + Top-of + (A, (Top-of, B)) means A is on the uppermost part, side, or surface of B. + + + Underneath + (A, (Underneath, B)) means A is situated directly below and may be concealed by B. + + + Upper-center-of + (A, (Upper-center-of, B)) means A is situated on the upper center part of B (due north). This relation is often used to specify qualitative information about screen position. + + relatedTag + Center-of + Lower-center-of + Lower-left-of + Lower-right-of + Upper-center-of + Upper-right-of + + + + Upper-left-of + (A, (Upper-left-of, B)) means A is situated on the upper left part of B. This relation is often used to specify qualitative information about screen position. + + relatedTag + Center-of + Lower-center-of + Lower-left-of + Lower-right-of + Upper-center-of + Upper-right-of + + + + Upper-right-of + (A, (Upper-right-of, B)) means A is situated on the upper right part of B. This relation is often used to specify qualitative information about screen position. + + relatedTag + Center-of + Lower-center-of + Lower-left-of + Upper-left-of + Upper-center-of + Lower-right-of + + + + Within + (A, (Within, B)) means A is on the inside of or contained in B. + + + + Temporal-relation + A relationship that includes a temporal or time-based component. + + After + (A, (After B)) means A happens at a time subsequent to a reference time related to B. + + + Asynchronous-with + (A, (Asynchronous-with, B)) means A happens at times not occurring at the same time or having the same period or phase as B. + + + Before + (A, (Before B)) means A happens at a time earlier in time or order than B. + + + During + (A, (During, B)) means A happens at some point in a given period of time in which B is ongoing. + + + Synchronous-with + (A, (Synchronous-with, B)) means A happens at occurs at the same time or rate as B. + + + Waiting-for + (A, (Waiting-for, B)) means A pauses for something to happen in B. + + + + + + + accelerationUnits + + defaultUnits + m-per-s^2 + + + m-per-s^2 + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + + angleUnits + + defaultUnits + radian + + + radian + + SIUnit + + + conversionFactor + 1.0 + + + + rad + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + degree + + conversionFactor + 0.0174533 + + + + + areaUnits + + defaultUnits + m^2 + + + m^2 + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + + currencyUnits + Units indicating the worth of something. + + defaultUnits + $ + + + dollar + + conversionFactor + 1.0 + + + + $ + + unitPrefix + + + unitSymbol + + + conversionFactor + 1.0 + + + + euro + + + point + + + + electricPotentialUnits + + defaultUnits + uv + + + v + + SIUnit + + + unitSymbol + + + conversionFactor + 0.000001 + + + + Volt + + SIUnit + + + conversionFactor + 0.000001 + + + + + frequencyUnits + + defaultUnits + Hz + + + hertz + + SIUnit + + + conversionFactor + 1.0 + + + + Hz + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + + intensityUnits + + defaultUnits + dB + + + dB + Intensity expressed as ratio to a threshold. May be used for sound intensity. + + unitSymbol + + + conversionFactor + 1.0 + + + + candela + Units used to express light intensity. + + SIUnit + + + + cd + Units used to express light intensity. + + SIUnit + + + unitSymbol + + + + + jerkUnits + + defaultUnits + m-per-s^3 + + + m-per-s^3 + + unitSymbol + + + conversionFactor + 1.0 + + + + + magneticFieldUnits + Units used to magnetic field intensity. + + defaultUnits + fT + + + tesla + + SIUnit + + + conversionFactor + 10^-15 + + + + T + + SIUnit + + + unitSymbol + + + conversionFactor + 10^-15 + + + + + memorySizeUnits + + defaultUnits + B + + + byte + + SIUnit + + + conversionFactor + 1.0 + + + + B + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + + physicalLengthUnits + + defaultUnits + m + + + foot + + conversionFactor + 0.3048 + + + + inch + + conversionFactor + 0.0254 + + + + meter + + SIUnit + + + conversionFactor + 1.0 + + + + metre + + SIUnit + + + conversionFactor + 1.0 + + + + m + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + mile + + conversionFactor + 1609.34 + + + + + speedUnits + + defaultUnits + m-per-s + + + m-per-s + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + mph + + unitSymbol + + + conversionFactor + 0.44704 + + + + kph + + unitSymbol + + + conversionFactor + 0.277778 + + + + + temperatureUnits + + degree Celsius + + SIUnit + + + conversionFactor + 1.0 + + + + oC + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + + timeUnits + + defaultUnits + s + + + second + + SIUnit + + + conversionFactor + 1.0 + + + + s + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + day + + conversionFactor + 86400 + + + + minute + + conversionFactor + 60 + + + + hour + Should be in 24-hour format. + + conversionFactor + 3600 + + + + + volumeUnits + + defaultUnits + m^3 + + + m^3 + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + + weightUnits + + defaultUnits + g + + + g + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + gram + + SIUnit + + + conversionFactor + 1.0 + + + + pound + + conversionFactor + 453.592 + + + + lb + + conversionFactor + 453.592 + + + + + + + deca + SI unit multiple representing 10^1. + + SIUnitModifier + + + conversionFactor + 10.0 + + + + da + SI unit multiple representing 10^1. + + SIUnitSymbolModifier + + + conversionFactor + 10.0 + + + + hecto + SI unit multiple representing 10^2. + + SIUnitModifier + + + conversionFactor + 100.0 + + + + h + SI unit multiple representing 10^2. + + SIUnitSymbolModifier + + + conversionFactor + 100.0 + + + + kilo + SI unit multiple representing 10^3. + + SIUnitModifier + + + conversionFactor + 1000.0 + + + + k + SI unit multiple representing 10^3. + + SIUnitSymbolModifier + + + conversionFactor + 1000.0 + + + + mega + SI unit multiple representing 10^6. + + SIUnitModifier + + + conversionFactor + 10^6 + + + + M + SI unit multiple representing 10^6. + + SIUnitSymbolModifier + + + conversionFactor + 10^6 + + + + giga + SI unit multiple representing 10^9. + + SIUnitModifier + + + conversionFactor + 10^9 + + + + G + SI unit multiple representing 10^9. + + SIUnitSymbolModifier + + + conversionFactor + 10^9 + + + + tera + SI unit multiple representing 10^12. + + SIUnitModifier + + + conversionFactor + 10^12 + + + + T + SI unit multiple representing 10^12. + + SIUnitSymbolModifier + + + conversionFactor + 10^12 + + + + peta + SI unit multiple representing 10^15. + + SIUnitModifier + + + conversionFactor + 10^15 + + + + P + SI unit multiple representing 10^15. + + SIUnitSymbolModifier + + + conversionFactor + 10^15 + + + + exa + SI unit multiple representing 10^18. + + SIUnitModifier + + + conversionFactor + 10^18 + + + + E + SI unit multiple representing 10^18. + + SIUnitSymbolModifier + + + conversionFactor + 10^18 + + + + zetta + SI unit multiple representing 10^21. + + SIUnitModifier + + + conversionFactor + 10^21 + + + + Z + SI unit multiple representing 10^21. + + SIUnitSymbolModifier + + + conversionFactor + 10^21 + + + + yotta + SI unit multiple representing 10^24. + + SIUnitModifier + + + conversionFactor + 10^24 + + + + Y + SI unit multiple representing 10^24. + + SIUnitSymbolModifier + + + conversionFactor + 10^24 + + + + deci + SI unit submultiple representing 10^-1. + + SIUnitModifier + + + conversionFactor + 0.1 + + + + d + SI unit submultiple representing 10^-1. + + SIUnitSymbolModifier + + + conversionFactor + 0.1 + + + + centi + SI unit submultiple representing 10^-2. + + SIUnitModifier + + + conversionFactor + 0.01 + + + + c + SI unit submultiple representing 10^-2. + + SIUnitSymbolModifier + + + conversionFactor + 0.01 + + + + milli + SI unit submultiple representing 10^-3. + + SIUnitModifier + + + conversionFactor + 0.001 + + + + m + SI unit submultiple representing 10^-3. + + SIUnitSymbolModifier + + + conversionFactor + 0.001 + + + + micro + SI unit submultiple representing 10^-6. + + SIUnitModifier + + + conversionFactor + 10^-6 + + + + u + SI unit submultiple representing 10^-6. + + SIUnitSymbolModifier + + + conversionFactor + 10^-6 + + + + nano + SI unit submultiple representing 10^-9. + + SIUnitModifier + + + conversionFactor + 10^-9 + + + + n + SI unit submultiple representing 10^-9. + + SIUnitSymbolModifier + + + conversionFactor + 10^-9 + + + + pico + SI unit submultiple representing 10^-12. + + SIUnitModifier + + + conversionFactor + 10^-12 + + + + p + SI unit submultiple representing 10^-12. + + SIUnitSymbolModifier + + + conversionFactor + 10^-12 + + + + femto + SI unit submultiple representing 10^-15. + + SIUnitModifier + + + conversionFactor + 10^-15 + + + + f + SI unit submultiple representing 10^-15. + + SIUnitSymbolModifier + + + conversionFactor + 10^-15 + + + + atto + SI unit submultiple representing 10^-18. + + SIUnitModifier + + + conversionFactor + 10^-18 + + + + a + SI unit submultiple representing 10^-18. + + SIUnitSymbolModifier + + + conversionFactor + 10^-18 + + + + zepto + SI unit submultiple representing 10^-21. + + SIUnitModifier + + + conversionFactor + 10^-21 + + + + z + SI unit submultiple representing 10^-21. + + SIUnitSymbolModifier + + + conversionFactor + 10^-21 + + + + yocto + SI unit submultiple representing 10^-24. + + SIUnitModifier + + + conversionFactor + 10^-24 + + + + y + SI unit submultiple representing 10^-24. + + SIUnitSymbolModifier + + + conversionFactor + 10^-24 + + + + + + dateTimeClass + Date-times should conform to ISO8601 date-time format YYYY-MM-DDThh:mm:ss. Any variation on the full form is allowed. + + allowedCharacter + digits + T + - + : + + + + nameClass + Value class designating values that have the characteristics of node names. The allowed characters are alphanumeric, hyphen, and underbar. + + allowedCharacter + letters + digits + _ + - + + + + numericClass + Value must be a valid numerical value. + + allowedCharacter + digits + E + e + + + - + . + + + + posixPath + Posix path specification. + + allowedCharacter + digits + letters + / + : + + + + textClass + Value class designating values that have the characteristics of text such as in descriptions. + + allowedCharacter + letters + digits + blank + + + - + : + ; + . + / + ( + ) + ? + * + % + $ + @ + + + + + + allowedCharacter + A schema attribute of value classes specifying a special character that is allowed in expressing the value of a placeholder. Normally the allowed characters are listed individually. However, the word letters designates the upper and lower case alphabetic characters and the word digits designates the digits 0-9. The word blank designates the blank character. + + valueClassProperty + + + + conversionFactor + The multiplicative factor to multiply these units to convert to default units. + + unitProperty + + + unitModifierProperty + + + + deprecatedFrom + Indicates that this element is deprecated. The value of the attribute is the latest schema version in which the element appeared in undeprecated form. + + elementProperty + + + + defaultUnits + A schema attribute of unit classes specifying the default units to use if the placeholder has a unit class but the substituted value has no units. + + unitClassProperty + + + + extensionAllowed + A schema attribute indicating that users can add unlimited levels of child nodes under this tag. This tag is propagated to child nodes with the exception of the hashtag placeholders. + + boolProperty + + + nodeProperty + + + isInheritedProperty + + + + inLibrary + Indicates this schema element came from the named library schema, not the standard schema. This attribute is added by tools when a library schema is merged into its partnered standard schema. + + elementProperty + + + + recommended + A schema attribute indicating that the event-level HED string should include this tag. + + boolProperty + + + nodeProperty + + + + relatedTag + A schema attribute suggesting HED tags that are closely related to this tag. This attribute is used by tagging tools. + + nodeProperty + + + isInheritedProperty + + + + requireChild + A schema attribute indicating that one of the node elements descendants must be included when using this tag. + + boolProperty + + + nodeProperty + + + + required + A schema attribute indicating that every event-level HED string should include this tag. + + boolProperty + + + nodeProperty + + + + reserved + A schema attribute indicating that this tag has special meaning and requires special handling by tools. + + boolProperty + + + nodeProperty + + + + rooted + Indicates a top-level library schema node is identical to a node of the same name in the partnered standard schema. This attribute can only appear in nodes that have the inLibrary schema attribute. + + nodeProperty + + + + SIUnit + A schema attribute indicating that this unit element is an SI unit and can be modified by multiple and submultiple names. Note that some units such as byte are designated as SI units although they are not part of the standard. + + boolProperty + + + unitProperty + + + + SIUnitModifier + A schema attribute indicating that this SI unit modifier represents a multiple or submultiple of a base unit rather than a unit symbol. + + boolProperty + + + unitModifierProperty + + + + SIUnitSymbolModifier + A schema attribute indicating that this SI unit modifier represents a multiple or submultiple of a unit symbol rather than a base symbol. + + boolProperty + + + unitModifierProperty + + + + suggestedTag + A schema attribute that indicates another tag that is often associated with this tag. This attribute is used by tagging tools to provide tagging suggestions. + + nodeProperty + + + isInheritedProperty + + + + tagGroup + A schema attribute indicating the tag can only appear inside a tag group. + + boolProperty + + + nodeProperty + + + + takesValue + A schema attribute indicating the tag is a hashtag placeholder that is expected to be replaced with a user-defined value. + + boolProperty + + + nodeProperty + + + + topLevelTagGroup + A schema attribute indicating that this tag (or its descendants) can only appear in a top-level tag group. A tag group can have at most one tag with this attribute. + + boolProperty + + + nodeProperty + + + + unique + A schema attribute indicating that only one of this tag or its descendants can be used in the event-level HED string. + + boolProperty + + + nodeProperty + + + + unitClass + A schema attribute specifying which unit class this value tag belongs to. + + nodeProperty + + + + unitPrefix + A schema attribute applied specifically to unit elements to designate that the unit indicator is a prefix (e.g., dollar sign in the currency units). + + boolProperty + + + unitProperty + + + + unitSymbol + A schema attribute indicating this tag is an abbreviation or symbol representing a type of unit. Unit symbols represent both the singular and the plural and thus cannot be pluralized. + + boolProperty + + + unitProperty + + + + valueClass + A schema attribute specifying which value class this value tag belongs to. + + nodeProperty + + + + + + boolProperty + Indicates that the schema attribute represents something that is either true or false and does not have a value. Attributes without this value are assumed to have string values. + + + elementProperty + Indicates this schema attribute can apply to any type of element(tag term, unit class, etc). + + + isInheritedProperty + Indicates that this attribute is inherited by child nodes. This property only applies to schema attributes for nodes. + + + nodeProperty + Indicates this schema attribute applies to node (tag-term) elements. This was added to allow for an attribute to apply to multiple elements. + + + unitClassProperty + Indicates that the schema attribute is meant to be applied to unit classes. + + + unitModifierProperty + Indicates that the schema attribute is meant to be applied to unit modifier classes. + + + unitProperty + Indicates that the schema attribute is meant to be applied to units within a unit class. + + + valueClassProperty + Indicates that the schema attribute is meant to be applied to value classes. + + + A final section. + diff --git a/hed/schema/schema_io/df2schema.py b/hed/schema/schema_io/df2schema.py index 27eab345e..fe69c82b8 100644 --- a/hed/schema/schema_io/df2schema.py +++ b/hed/schema/schema_io/df2schema.py @@ -7,7 +7,7 @@ import hed.schema.schema_io.ontology_util from hed.schema.hed_schema_constants import HedSectionKey, HedKey from hed.errors.exceptions import HedFileError, HedExceptions -from .base2schema import SchemaLoader +from hed.schema.schema_io.base2schema import SchemaLoader import pandas as pd import hed.schema.hed_schema_df_constants as constants from hed.errors import error_reporter diff --git a/hed/schema/schema_io/ontology_util.py b/hed/schema/schema_io/ontology_util.py index c2ae77363..7461bf561 100644 --- a/hed/schema/schema_io/ontology_util.py +++ b/hed/schema/schema_io/ontology_util.py @@ -4,7 +4,7 @@ import pandas as pd from hed.schema.schema_io import schema_util -from hed.errors import HedFileError +from hed.errors.exceptions import HedFileError from hed.schema import hed_schema_df_constants as constants from hed.schema.hed_schema_constants import HedKey from hed.schema.schema_io.text_util import parse_attribute_string diff --git a/hed/schema/schema_io/wiki2schema.py b/hed/schema/schema_io/wiki2schema.py index 0208aeb3a..22b339a2e 100644 --- a/hed/schema/schema_io/wiki2schema.py +++ b/hed/schema/schema_io/wiki2schema.py @@ -7,8 +7,8 @@ from hed.errors.exceptions import HedFileError, HedExceptions from hed.errors import error_reporter from hed.schema.schema_io import wiki_constants -from .base2schema import SchemaLoader -from .wiki_constants import HedWikiSection, SectionStarts, SectionNames +from hed.schema.schema_io.base2schema import SchemaLoader +from hed.schema.schema_io.wiki_constants import HedWikiSection, SectionStarts, SectionNames from hed.schema.schema_io import text_util diff --git a/hed/schema/schema_io/xml2schema.py b/hed/schema/schema_io/xml2schema.py index c6d2a4c52..a814cd17d 100644 --- a/hed/schema/schema_io/xml2schema.py +++ b/hed/schema/schema_io/xml2schema.py @@ -8,7 +8,7 @@ from hed.errors.exceptions import HedFileError, HedExceptions from hed.schema.hed_schema_constants import HedSectionKey, HedKey, NS_ATTRIB, NO_LOC_ATTRIB from hed.schema.schema_io import xml_constants -from .base2schema import SchemaLoader +from hed.schema.schema_io.base2schema import SchemaLoader from functools import partial diff --git a/hed/schema/schema_io/xml_constants.py b/hed/schema/schema_io/xml_constants.py index 332b5edba..8b75fb143 100644 --- a/hed/schema/schema_io/xml_constants.py +++ b/hed/schema/schema_io/xml_constants.py @@ -1,3 +1,5 @@ +""" Constants used for the """ + from hed.schema.hed_schema_constants import HedSectionKey # These are only currently used by the XML reader/writer, but that may change. diff --git a/hed/schema/schema_validation_util.py b/hed/schema/schema_validation_util.py index a6f177984..87ac07b35 100644 --- a/hed/schema/schema_validation_util.py +++ b/hed/schema/schema_validation_util.py @@ -1,10 +1,10 @@ """Utilities used in HED validation/loading using a HED schema.""" -from semantic_version import Version -from hed.errors import ErrorHandler, SchemaWarnings +from hed.errors.error_reporter import ErrorHandler +from hed.errors.error_types import SchemaWarnings from hed.schema import hed_schema_constants as constants from hed.schema.hed_schema_constants import character_types -from hed.schema import HedSchema, HedSchemaGroup +from hed.schema.hed_schema import HedSchema def validate_schema_tag_new(hed_entry): diff --git a/hed/schema/schema_validation_util_deprecated.py b/hed/schema/schema_validation_util_deprecated.py index 0a0a9ccfc..fe8a36784 100644 --- a/hed/schema/schema_validation_util_deprecated.py +++ b/hed/schema/schema_validation_util_deprecated.py @@ -1,5 +1,6 @@ """Legacy validation for terms and descriptions prior to 8.3.0.""" -from hed.errors import ErrorHandler, SchemaWarnings +from hed.errors.error_reporter import ErrorHandler +from hed.errors.error_types import SchemaWarnings ALLOWED_TAG_CHARS = "-" diff --git a/hed/tools/__init__.py b/hed/tools/__init__.py index 350a2497c..2d0bd977d 100644 --- a/hed/tools/__init__.py +++ b/hed/tools/__init__.py @@ -1,7 +1,8 @@ """ HED remodeling, analysis and summarization tools. """ +from .analysis.event_manager import EventManager from .analysis.file_dictionary import FileDictionary -# from .analysis.hed_context_manager import OnsetGroup, HedContextManager +from .analysis.hed_tag_manager import HedTagManager from .analysis.hed_type_defs import HedTypeDefs from .analysis.hed_type_factors import HedTypeFactors from .analysis.hed_type import HedType @@ -9,6 +10,7 @@ from .analysis.hed_type_counts import HedTypeCount from .analysis.key_map import KeyMap from .analysis.tabular_summary import TabularSummary +from .analysis.temporal_event import TemporalEvent from .bids.bids_dataset import BidsDataset from .bids.bids_file import BidsFile from .bids.bids_file_dictionary import BidsFileDictionary @@ -43,9 +45,9 @@ from .util.io_util import check_filename, clean_filename, extract_suffix_path, get_file_list, make_path from .util.io_util import get_dir_dictionary, get_file_list, get_path_components, parse_bids_filename -from .analysis import annotation_util from .analysis.annotation_util import \ - check_df_columns, extract_tags, generate_sidecar_entry, hed_to_df, df_to_hed, merge_hed_dict + check_df_columns, extract_tags, generate_sidecar_entry, get_bids_dataset, hed_to_df, df_to_hed, merge_hed_dict, \ + str_to_tabular, strs_to_sidecar, to_strlist from .remodeling.cli import run_remodel from .remodeling.cli import run_remodel_backup diff --git a/hed/tools/analysis/__init__.py b/hed/tools/analysis/__init__.py index 82bf112d7..30c11f83a 100644 --- a/hed/tools/analysis/__init__.py +++ b/hed/tools/analysis/__init__.py @@ -1,10 +1,14 @@ """ Basic analysis tools. """ from .file_dictionary import FileDictionary -# from .hed_context_manager import OnsetGroup, HedContextManager +from .annotation_util import (check_df_columns, df_to_hed, extract_tags, generate_sidecar_entry, get_bids_dataset, + hed_to_df, str_to_tabular, strs_to_sidecar, to_strlist) +from .event_manager import EventManager +from .hed_tag_manager import HedTagManager from .hed_type_defs import HedTypeDefs from .hed_type_factors import HedTypeFactors from .hed_type import HedType from .hed_type_manager import HedTypeManager from .hed_type_counts import HedTypeCount from .key_map import KeyMap -from .tabular_summary import TabularSummary \ No newline at end of file +from .tabular_summary import TabularSummary +from .temporal_event import TemporalEvent \ No newline at end of file diff --git a/hed/tools/analysis/annotation_util.py b/hed/tools/analysis/annotation_util.py index a055f29f6..82d0d99bc 100644 --- a/hed/tools/analysis/annotation_util.py +++ b/hed/tools/analysis/annotation_util.py @@ -2,10 +2,13 @@ import io import re -from pandas import DataFrame -from hed.models import Sidecar, TabularInput + +import pandas as pd +from hed.models.sidecar import Sidecar +from hed.models.tabular_input import TabularInput from hed.errors.exceptions import HedFileError -from hed.models.df_util import replace_ref +from hed.models import df_util +from hed.tools.bids.bids_dataset import BidsDataset def check_df_columns(df, required_cols=('column_name', 'column_value', 'description', 'HED')): @@ -60,6 +63,21 @@ def df_to_hed(dataframe, description_tag=True): return hed_dict +def series_to_factor(series): + """Convert a series to an integer factor list. + + Parameters: + series (Series) - Series to be converted to a list. + + Returns: + list - contains 0's and 1's, empty, 'n/a' and np.NAN are converted to 0. + """ + replaced = series.replace('n/a', False) + filled = replaced.fillna(False) + bool_list = filled.astype(bool).tolist() + return [int(value) for value in bool_list] + + def extract_tags(hed_string, search_tag): """ Extract all instances of specified tag from a tag_string. @@ -77,7 +95,7 @@ def extract_tags(hed_string, search_tag): extracted = [tag.strip() for tag in possible_descriptions if search_tag in tag] remainder = hed_string for tag in extracted: - remainder = replace_ref(remainder, tag) + remainder = df_util.replace_ref(remainder, tag) return remainder, extracted @@ -111,6 +129,17 @@ def generate_sidecar_entry(column_name, column_values=None): sidecar_entry["HED"] = hed return sidecar_entry +def get_bids_dataset(data_root): + """ Return a BIDS dataset object given a path to a dataset root. + + Parameters: + data_root (str): Path to the BIDS dataset root. + + Returns: + BidsDataset + + """ + return BidsDataset(data_root) def hed_to_df(sidecar_dict, col_names=None): """ Return a 4-column dataframe of HED portions of sidecar. @@ -148,7 +177,7 @@ def hed_to_df(sidecar_dict, col_names=None): data = {"column_name": column_name, "column_value": column_value, "description": column_description, "HED": hed_tags} - dataframe = DataFrame(data).astype(str) + dataframe = pd.DataFrame(data).astype(str) return dataframe @@ -207,6 +236,31 @@ def strs_to_sidecar(sidecar_strings): else: return None +def to_factor(data, column=None): + """Convert data to an integer factor list. + + Parameters: + data (Series or DataFrame) - Series to be converted to a list. + column (str): Optional column name if DataFrame (otherwise column 0). + + Returns: + list - contains 0's and 1's, empty, 'n/a' and np.NAN are converted to 0. + """ + if isinstance(data, pd.Series): + series = data + elif isinstance(data, pd.DataFrame) and column: + series = data[column] + elif isinstance(data, pd.DataFrame): + series = data.iloc[:, 0] + else: + raise HedFileError("CannotConvertToFactor", + f"Expecting Series or DataFrame but got {type(data)}", "") + + replaced = series.replace('n/a', False) + filled = replaced.fillna(False) + bool_list = filled.astype(bool).tolist() + return [int(value) for value in bool_list] + def to_strlist(obj_list): """ Return a list with the objects converted to string except for None elements. diff --git a/hed/tools/analysis/event_manager.py b/hed/tools/analysis/event_manager.py index 9bdc5183c..42a0fb7b3 100644 --- a/hed/tools/analysis/event_manager.py +++ b/hed/tools/analysis/event_manager.py @@ -2,11 +2,11 @@ import pandas as pd import bisect -from hed.errors import HedFileError -from hed.models import HedString +from hed.errors.exceptions import HedFileError +from hed.models.hed_string import HedString from hed.models.model_constants import DefTagNames from hed.models import df_util -from hed.models.string_util import split_base_tags, split_def_tags +from hed.models import string_util from hed.tools.analysis.temporal_event import TemporalEvent from hed.tools.analysis.hed_type_defs import HedTypeDefs @@ -176,9 +176,9 @@ def _filter_hed(self, hed, remove_types=[], remove_defs=[], remove_group=False): return "" # Reconvert even if HED is already a HedString to make sure a copy and expandable. hed_obj = HedString(str(hed), hed_schema=self.hed_schema, def_dict=self.def_dict) - hed_obj, temp1 = split_base_tags(hed_obj, remove_types, remove_group=remove_group) + hed_obj, temp1 = string_util.split_base_tags(hed_obj, remove_types, remove_group=remove_group) if remove_defs: - hed_obj, temp2 = split_def_tags(hed_obj, remove_defs, remove_group=remove_group) + hed_obj, temp2 = string_util.split_def_tags(hed_obj, remove_defs, remove_group=remove_group) return str(hed_obj) def str_list_to_hed(self, str_list): diff --git a/hed/tools/analysis/hed_tag_manager.py b/hed/tools/analysis/hed_tag_manager.py index 1cd3041f2..9464a50ad 100644 --- a/hed/tools/analysis/hed_tag_manager.py +++ b/hed/tools/analysis/hed_tag_manager.py @@ -1,7 +1,7 @@ """ Manager for HED tags from a columnar file. """ -from hed.models import HedString -from hed.models.string_util import split_base_tags +from hed.models.hed_string import HedString +from hed.models import string_util class HedTagManager: @@ -58,5 +58,5 @@ def get_hed_obj(self, hed_str, remove_types=False, remove_group=False): return None hed_obj = HedString(hed_str, self.event_manager.hed_schema, def_dict=self.event_manager.def_dict) if remove_types: - hed_obj, temp = split_base_tags(hed_obj, self.remove_types, remove_group=remove_group) + hed_obj, temp = string_util.split_base_tags(hed_obj, self.remove_types, remove_group=remove_group) return hed_obj diff --git a/hed/tools/analysis/hed_type.py b/hed/tools/analysis/hed_type.py index 60cb1a3d2..d5425e224 100644 --- a/hed/tools/analysis/hed_type.py +++ b/hed/tools/analysis/hed_type.py @@ -1,6 +1,7 @@ """ Manager a type variable and its associated context. """ import pandas as pd -from hed.models import HedGroup, HedTag +from hed.models.hed_group import HedGroup +from hed.models.hed_tag import HedTag from hed.models.model_constants import DefTagNames from hed.tools.analysis.hed_type_defs import HedTypeDefs from hed.tools.analysis.hed_type_factors import HedTypeFactors diff --git a/hed/tools/analysis/key_map.py b/hed/tools/analysis/key_map.py index 50eec864c..472a42dce 100644 --- a/hed/tools/analysis/key_map.py +++ b/hed/tools/analysis/key_map.py @@ -3,7 +3,7 @@ import pandas as pd from hed.errors.exceptions import HedFileError -from hed.tools.util.data_util import get_new_dataframe, get_row_hash, separate_values +from hed.tools.util import data_util class KeyMap: @@ -55,7 +55,7 @@ def columns(self): def __str__(self): temp_list = [f"{self.name} counts for key [{str(self.key_cols)}]:"] for index, row in self.col_map.iterrows(): - key_hash = get_row_hash(row, self.columns) + key_hash = data_util.get_row_hash(row, self.columns) temp_list.append(f"{str(list(row.values))}:\t{self.count_dict[key_hash]}") return "\n".join(temp_list) @@ -98,7 +98,7 @@ def _get_counts(self): """ counts = [0 for _ in range(len(self.col_map))] for index, row in self.col_map.iterrows(): - key_hash = get_row_hash(row, self.key_cols) + key_hash = data_util.get_row_hash(row, self.key_cols) counts[index] = self.count_dict[key_hash] return counts @@ -118,8 +118,8 @@ def remap(self, data): """ - df_new = get_new_dataframe(data) - present_keys, missing_keys = separate_values(df_new.columns.values.tolist(), self.key_cols) + df_new = data_util.get_new_dataframe(data) + present_keys, missing_keys = data_util.separate_values(df_new.columns.values.tolist(), self.key_cols) if missing_keys: raise HedFileError("MissingKeys", f"File must have key columns {str(self.key_cols)}", "") self.remove_quotes(df_new, columns=present_keys) @@ -140,7 +140,7 @@ def _remap(self, df): missing_indices = [] for index, row in df.iterrows(): - key = get_row_hash(row, self.key_cols) + key = data_util.get_row_hash(row, self.key_cols) key_value = self.map_dict.get(key, None) if key_value is not None: result = self.col_map.iloc[key_value] @@ -154,7 +154,7 @@ def resort(self): """ Sort the col_map in place by the key columns. """ self.col_map.sort_values(by=self.key_cols, inplace=True, ignore_index=True) for index, row in self.col_map.iterrows(): - key_hash = get_row_hash(row, self.key_cols) + key_hash = data_util.get_row_hash(row, self.key_cols) self.map_dict[key_hash] = index def update(self, data, allow_missing=True): @@ -168,9 +168,9 @@ def update(self, data, allow_missing=True): - If there are missing keys and allow_missing is False. """ - df = get_new_dataframe(data) + df = data_util.get_new_dataframe(data) col_list = df.columns.values.tolist() - keys_present, keys_missing = separate_values(col_list, self.key_cols) + keys_present, keys_missing = data_util.separate_values(col_list, self.key_cols) if keys_missing and not allow_missing: raise HedFileError("MissingKeyColumn", f"make_template data does not have key columns {str(keys_missing)}", "") @@ -181,7 +181,7 @@ def update(self, data, allow_missing=True): base_df[keys_missing] = 'n/a' if self.target_cols: base_df[self.target_cols] = 'n/a' - targets_present, targets_missing = separate_values(col_list, self.target_cols) + targets_present, targets_missing = data_util.separate_values(col_list, self.target_cols) if targets_present: base_df[targets_present] = df[targets_present].values self._update(base_df) @@ -217,7 +217,7 @@ def _handle_update(self, row, row_list, next_pos): tuple: (key, pos_update) key is the row hash and pos_update is 1 if new row or 0 otherwise. """ - key = get_row_hash(row, self.key_cols) + key = data_util.get_row_hash(row, self.key_cols) pos_update = 0 if key not in self.map_dict: self.map_dict[key] = next_pos diff --git a/hed/tools/analysis/sequence_map.py b/hed/tools/analysis/sequence_map.py index 4ac5d79eb..763d85f21 100644 --- a/hed/tools/analysis/sequence_map.py +++ b/hed/tools/analysis/sequence_map.py @@ -2,7 +2,7 @@ import pandas as pd -from hed.tools.util.data_util import get_key_hash +from hed.tools.util import data_util class SequenceMap: @@ -122,7 +122,7 @@ def update(self, data): if index + 1 >= len(filtered): break key_list = filtered[index:index+2].tolist() - key = get_key_hash(key_list) + key = data_util.get_key_hash(key_list) if key in self.edges: self.edge_counts[key] = self.edge_counts[key] + 1 else: diff --git a/hed/tools/analysis/tabular_summary.py b/hed/tools/analysis/tabular_summary.py index 73439e589..76d26c69c 100644 --- a/hed/tools/analysis/tabular_summary.py +++ b/hed/tools/analysis/tabular_summary.py @@ -3,8 +3,8 @@ import json from hed.errors.exceptions import HedFileError -from hed.tools.util.data_util import get_new_dataframe -from hed.tools.analysis.annotation_util import generate_sidecar_entry +from hed.tools.util import data_util +from hed.tools.analysis import annotation_util class TabularSummary: @@ -68,10 +68,10 @@ def extract_sidecar_template(self): for column_name, columns in self.categorical_info.items(): column_values = list(columns.keys()) column_values.sort() - side_dict[column_name] = generate_sidecar_entry(column_name, column_values) + side_dict[column_name] = annotation_util.generate_sidecar_entry(column_name, column_values) for column_name in self.value_info.keys(): - side_dict[column_name] = generate_sidecar_entry(column_name, []) + side_dict[column_name] = annotation_util.generate_sidecar_entry(column_name, []) return side_dict def get_summary(self, as_json=False): @@ -184,7 +184,7 @@ def _update_dataframe(self, data, name): name (str): Name of the file corresponding to data. """ - df = get_new_dataframe(data) + df = data_util.get_new_dataframe(data) if name: self.files[name] = "" self.total_files = self.total_files + 1 @@ -326,7 +326,7 @@ def make_combined_dicts(file_dictionary, skip_cols=None): summary_dict = {} for key, file_path in file_dictionary.items(): orig_dict = TabularSummary(skip_cols=skip_cols) - df = get_new_dataframe(file_path) + df = data_util.get_new_dataframe(file_path) orig_dict.update(df) summary_dict[key] = orig_dict summary_all.update_summary(orig_dict) diff --git a/hed/tools/analysis/temporal_event.py b/hed/tools/analysis/temporal_event.py index f32f632fd..9f075f522 100644 --- a/hed/tools/analysis/temporal_event.py +++ b/hed/tools/analysis/temporal_event.py @@ -1,5 +1,5 @@ """ A single event process with starting and ending times. """ -from hed.models import HedGroup +from hed.models.hed_group import HedGroup from hed.models.model_constants import DefTagNames diff --git a/hed/tools/bids/bids_file.py b/hed/tools/bids/bids_file.py index c3dc06242..22be04809 100644 --- a/hed/tools/bids/bids_file.py +++ b/hed/tools/bids/bids_file.py @@ -1,7 +1,7 @@ """ Models a BIDS file. """ import os -from hed.tools.util.io_util import parse_bids_filename +from hed.tools.util import io_util class BidsFile: @@ -27,7 +27,7 @@ def __init__(self, file_path): """ self.file_path = os.path.realpath(file_path) - suffix, ext, entity_dict = parse_bids_filename(self.file_path) + suffix, ext, entity_dict = io_util.parse_bids_filename(self.file_path) self.suffix = suffix self.ext = ext self.entity_dict = entity_dict diff --git a/hed/tools/bids/bids_file_group.py b/hed/tools/bids/bids_file_group.py index 0f04abdbb..37068304a 100644 --- a/hed/tools/bids/bids_file_group.py +++ b/hed/tools/bids/bids_file_group.py @@ -6,7 +6,7 @@ from hed.tools.analysis.tabular_summary import TabularSummary from hed.tools.bids.bids_tabular_file import BidsTabularFile from hed.tools.bids.bids_sidecar_file import BidsSidecarFile -from hed.tools.util.io_util import get_dir_dictionary, get_file_list, get_path_components +from hed.tools.util import io_util class BidsFileGroup: @@ -62,7 +62,7 @@ def get_sidecars_from_path(self, obj): list: A list of the paths for applicable sidecars for obj starting at the root. """ - path_components = [self.root_path] + get_path_components(self.root_path, obj.file_path) + path_components = [self.root_path] + io_util.get_path_components(self.root_path, obj.file_path) sidecar_list = [] current_path = '' for comp in path_components: @@ -167,7 +167,7 @@ def _make_datafile_dict(self): dict: A dictionary of BidsTabularFile or BidsTimeseriesFile objects keyed by real path. """ - files = get_file_list(self.root_path, name_suffix=self.suffix, extensions=['.tsv'], + files = io_util.get_file_list(self.root_path, name_suffix=self.suffix, extensions=['.tsv'], exclude_dirs=self.exclude_dirs) file_dict = {} if self.obj_type == "tabular": @@ -187,7 +187,7 @@ def _make_sidecar_dict(self): - This function creates the sidecars, but does not set their contents. """ - files = get_file_list(self.root_path, name_suffix=self.suffix, + files = io_util.get_file_list(self.root_path, name_suffix=self.suffix, extensions=['.json'], exclude_dirs=self.exclude_dirs) file_dict = {} for file in files: @@ -201,7 +201,7 @@ def _make_sidecar_dir_dict(self): dict: A dictionary of lists of sidecar BidsSidecarFiles """ - dir_dict = get_dir_dictionary(self.root_path, name_suffix=self.suffix, extensions=['.json'], + dir_dict = io_util.get_dir_dictionary(self.root_path, name_suffix=self.suffix, extensions=['.json'], exclude_dirs=self.exclude_dirs) sidecar_dir_dict = {} for this_dir, dir_list in dir_dict.items(): diff --git a/hed/tools/remodeling/__init__.py b/hed/tools/remodeling/__init__.py index a13ce4b89..e6a9e2ea8 100644 --- a/hed/tools/remodeling/__init__.py +++ b/hed/tools/remodeling/__init__.py @@ -1 +1,5 @@ -""" Remodeling tools for revising and summarizing tabular files.""" \ No newline at end of file +""" Remodeling tools for revising and summarizing tabular files.""" + +from .backup_manager import BackupManager +from .dispatcher import Dispatcher +from .remodeler_validator import RemodelerValidator \ No newline at end of file diff --git a/hed/tools/remodeling/backup_manager.py b/hed/tools/remodeling/backup_manager.py index b9618e98d..475717607 100644 --- a/hed/tools/remodeling/backup_manager.py +++ b/hed/tools/remodeling/backup_manager.py @@ -5,7 +5,7 @@ import shutil from datetime import datetime from hed.errors.exceptions import HedFileError -from hed.tools.util.io_util import get_file_list, get_path_components +from hed.tools.util import io_util class BackupManager: @@ -137,7 +137,7 @@ def get_backup_path(self, backup_name, file_name): self.get_file_key(file_name))) def get_file_key(self, file_name): - file_comp = get_path_components(self.data_root, file_name) + [os.path.basename(file_name)] + file_comp = io_util.get_path_components(self.data_root, file_name) + [os.path.basename(file_name)] return '/'.join(file_comp) def restore_backup(self, backup_name=DEFAULT_BACKUP_NAME, task_names=[], verbose=True): @@ -218,7 +218,7 @@ def _check_backup_consistency(self, backup_name): backup_dict = json.load(fp) backup_paths = set([os.path.realpath(os.path.join(backup_root_path, backup_key)) for backup_key in backup_dict.keys()]) - file_paths = set(get_file_list(backup_root_path)) + file_paths = set(io_util.get_file_list(backup_root_path)) files_not_in_backup = list(file_paths.difference(backup_paths)) backups_not_in_directory = list(backup_paths.difference(file_paths)) return backup_dict, files_not_in_backup, backups_not_in_directory diff --git a/hed/tools/remodeling/cli/run_remodel.py b/hed/tools/remodeling/cli/run_remodel.py index 348014dfe..f935bfbbe 100644 --- a/hed/tools/remodeling/cli/run_remodel.py +++ b/hed/tools/remodeling/cli/run_remodel.py @@ -10,7 +10,7 @@ from hed.tools.remodeling.remodeler_validator import RemodelerValidator from hed.tools.remodeling.dispatcher import Dispatcher from hed.tools.remodeling.backup_manager import BackupManager -from hed.tools.util.io_util import get_alphanumeric_path, get_file_list, get_task_dict, get_timestamp +from hed.tools.util import io_util def get_parser(): @@ -132,7 +132,7 @@ def parse_tasks(files, task_args): """ if not task_args: return {"": files} - task_dict = get_task_dict(files) + task_dict = io_util.get_task_dict(files) if task_args == "*" or isinstance(task_args, list) and task_args[0] == "*": return task_dict task_dict = {key: task_dict[key] for key in task_args if key in task_dict} @@ -209,7 +209,7 @@ def main(arg_list=None): if args.log_dir: os.makedirs(args.log_dir, exist_ok=True) - timestamp = get_timestamp() + timestamp = io_util.get_timestamp() try: if not os.path.isdir(args.data_dir): raise HedFileError("DataDirectoryDoesNotExist", f"The root data directory {args.data_dir} does not exist", "") @@ -217,7 +217,7 @@ def main(arg_list=None): save_dir = None if args.work_dir: save_dir = os.path.realpath(os.path.join(args.work_dir, Dispatcher.REMODELING_SUMMARY_PATH)) - files = get_file_list(args.data_dir, name_suffix=args.file_suffix, extensions=args.extensions, + files = io_util.get_file_list(args.data_dir, name_suffix=args.file_suffix, extensions=args.extensions, exclude_dirs=args.exclude_dirs) task_dict = parse_tasks(files, args.task_names) for task, files in task_dict.items(): @@ -232,7 +232,7 @@ def main(arg_list=None): summary_dir=save_dir, task_name=task) except Exception as ex: if args.log_dir: - log_name = get_alphanumeric_path(os.path.realpath(args.data_dir)) + '_' + timestamp + '.txt' + log_name = io_util.get_alphanumeric_path(os.path.realpath(args.data_dir)) + '_' + timestamp + '.txt' logging.basicConfig(filename=os.path.join(args.log_dir, log_name), level=logging.ERROR) logging.exception(f"{args.data_dir}: {args.model_path}") raise diff --git a/hed/tools/remodeling/cli/run_remodel_backup.py b/hed/tools/remodeling/cli/run_remodel_backup.py index 3c4fcc980..8f97ddfcf 100644 --- a/hed/tools/remodeling/cli/run_remodel_backup.py +++ b/hed/tools/remodeling/cli/run_remodel_backup.py @@ -2,7 +2,7 @@ import argparse from hed.errors.exceptions import HedFileError -from hed.tools.util.io_util import get_file_list, get_filtered_by_element +from hed.tools.util import io_util from hed.tools.remodeling.backup_manager import BackupManager @@ -53,10 +53,10 @@ def main(arg_list=None): if '*' in args.extensions: args.extensions = None exclude_dirs = args.exclude_dirs + ['remodeling'] - file_list = get_file_list(args.data_dir, name_suffix=args.file_suffix, extensions=args.extensions, + file_list = io_util.get_file_list(args.data_dir, name_suffix=args.file_suffix, extensions=args.extensions, exclude_dirs=exclude_dirs) if args.task_names: - file_list = get_filtered_by_element(file_list, args.task_names) + file_list = io_util.get_filtered_by_element(file_list, args.task_names) if args.backup_dir: backups_root = args.backup_dir else: diff --git a/hed/tools/remodeling/dispatcher.py b/hed/tools/remodeling/dispatcher.py index 94bfa4589..baa71b11c 100644 --- a/hed/tools/remodeling/dispatcher.py +++ b/hed/tools/remodeling/dispatcher.py @@ -6,10 +6,11 @@ import json from hed.errors.exceptions import HedFileError from hed.schema.hed_schema_io import load_schema_version -from hed.schema import HedSchema, HedSchemaGroup +from hed.schema.hed_schema import HedSchema +from hed.schema.hed_schema_group import HedSchemaGroup from hed.tools.remodeling.backup_manager import BackupManager from hed.tools.remodeling.operations.valid_operations import valid_operations -from hed.tools.util.io_util import clean_filename, extract_suffix_path, get_timestamp +from hed.tools.util import io_util # This isn't supported in all versions of pandas try: @@ -63,12 +64,12 @@ def get_summaries(self, file_formats=['.txt', '.json']): """ summary_list = [] - time_stamp = '_' + get_timestamp() + time_stamp = '_' + io_util.get_timestamp() for context_name, context_item in self.summary_dicts.items(): file_base = context_item.op.summary_filename if self.data_root: - file_base = extract_suffix_path(self.data_root, file_base) - file_base = clean_filename(file_base) + file_base = io_util.extract_suffix_path(self.data_root, file_base) + file_base = io_util.clean_filename(file_base) for file_format in file_formats: if file_format == '.txt': summary = context_item.get_text_summary(individual_summaries="consolidated") diff --git a/hed/tools/remodeling/operations/__init__.py b/hed/tools/remodeling/operations/__init__.py index 6f2ea63de..b54345a8a 100644 --- a/hed/tools/remodeling/operations/__init__.py +++ b/hed/tools/remodeling/operations/__init__.py @@ -1 +1 @@ -""" Remodeling operations. """ \ No newline at end of file +""" Remodeling operations. """ diff --git a/hed/tools/remodeling/operations/base_summary.py b/hed/tools/remodeling/operations/base_summary.py index a1fa9f87f..dfafd05aa 100644 --- a/hed/tools/remodeling/operations/base_summary.py +++ b/hed/tools/remodeling/operations/base_summary.py @@ -3,7 +3,7 @@ import os from abc import ABC, abstractmethod import json -from hed.tools.util.io_util import get_timestamp +from hed.tools.util import io_util class BaseSummary(ABC): @@ -189,7 +189,7 @@ def _save_summary_files(self, save_dir, file_format, summary, individual_summari """ if self.op.append_timecode: - time_stamp = '_' + get_timestamp() + time_stamp = '_' + io_util.get_timestamp() else: time_stamp = '' if task_name: diff --git a/hed/tools/remodeling/operations/factor_hed_tags_op.py b/hed/tools/remodeling/operations/factor_hed_tags_op.py index fa7fb03e0..9ae70a9c4 100644 --- a/hed/tools/remodeling/operations/factor_hed_tags_op.py +++ b/hed/tools/remodeling/operations/factor_hed_tags_op.py @@ -6,7 +6,7 @@ from hed.tools.remodeling.operations.base_op import BaseOp from hed.models.tabular_input import TabularInput from hed.models.sidecar import Sidecar -from hed.models.query_service import search_strings, get_query_handlers +from hed.models import query_service from hed.tools.analysis.event_manager import EventManager from hed.tools.analysis.hed_tag_manager import HedTagManager @@ -89,7 +89,7 @@ def __init__(self, parameters): self.expand_context = parameters.get('expand_context', True) self.replace_defs = parameters.get('replace_defs', True) self.query_handlers, self.query_names, issues = \ - get_query_handlers(self.queries, parameters.get('query_names', None)) + query_service.get_query_handlers(self.queries, parameters.get('query_names', None)) if issues: raise ValueError("FactorHedTagInvalidQueries", "\n".join(issues)) @@ -122,7 +122,7 @@ def do_op(self, dispatcher, df, name, sidecar=None): tag_man = HedTagManager(EventManager(input_data, dispatcher.hed_schema), remove_types=self.remove_types) hed_objs = tag_man.get_hed_objs(include_context=self.expand_context, replace_defs=self.replace_defs) - df_factors = search_strings(hed_objs, self.query_handlers, query_names=self.query_names) + df_factors = query_service.search_strings(hed_objs, self.query_handlers, query_names=self.query_names) if len(df_factors.columns) > 0: df_list.append(df_factors) df_new = pd.concat(df_list, axis=1) @@ -140,5 +140,6 @@ def validate_input_data(parameters): list: List of issues in parsing queries. """ - queries, names, issues = get_query_handlers(parameters.get("queries", []), parameters.get("query_names", None)) + queries, names, issues = query_service.get_query_handlers(parameters.get("queries", []), + parameters.get("query_names", None)) return issues diff --git a/hed/tools/remodeling/operations/summarize_column_values_op.py b/hed/tools/remodeling/operations/summarize_column_values_op.py index 0e8820cb8..97f1e9096 100644 --- a/hed/tools/remodeling/operations/summarize_column_values_op.py +++ b/hed/tools/remodeling/operations/summarize_column_values_op.py @@ -1,6 +1,6 @@ """ Summarize the values in the columns of a columnar file. """ -from hed.tools import TabularSummary +from hed.tools.analysis.tabular_summary import TabularSummary from hed.tools.remodeling.operations.base_op import BaseOp from hed.tools.remodeling.operations.base_summary import BaseSummary diff --git a/hed/tools/remodeling/operations/summarize_definitions_op.py b/hed/tools/remodeling/operations/summarize_definitions_op.py index 5088aca3f..76b3a5072 100644 --- a/hed/tools/remodeling/operations/summarize_definitions_op.py +++ b/hed/tools/remodeling/operations/summarize_definitions_op.py @@ -1,6 +1,6 @@ """ Summarize the type_defs in the dataset. """ -from hed import TabularInput +from hed.models.tabular_input import TabularInput from hed.tools.remodeling.operations.base_op import BaseOp from hed.tools.remodeling.operations.base_summary import BaseSummary from hed.models.def_expand_gather import DefExpandGatherer diff --git a/hed/tools/remodeling/operations/summarize_hed_tags_op.py b/hed/tools/remodeling/operations/summarize_hed_tags_op.py index f899baf51..a45e7b86e 100644 --- a/hed/tools/remodeling/operations/summarize_hed_tags_op.py +++ b/hed/tools/remodeling/operations/summarize_hed_tags_op.py @@ -7,7 +7,7 @@ from hed.tools.analysis.hed_tag_manager import HedTagManager from hed.tools.remodeling.operations.base_op import BaseOp from hed.tools.remodeling.operations.base_summary import BaseSummary -from hed.tools.visualization.tag_word_cloud import create_wordcloud, word_cloud_to_svg +from hed.tools.visualization import tag_word_cloud class SummarizeHedTagsOp(BaseOp): @@ -335,12 +335,13 @@ def save_visualizations(self, save_dir, file_formats=['.svg'], individual_summar specifics = overall_summary.get("Specifics", {}) word_dict = self.summary_to_dict(specifics, scale_adjustment=wc["scale_adjustment"]) - tag_wc = create_wordcloud(word_dict, mask_path=wc["mask_path"], width=wc["width"], height=wc["height"], + tag_wc = tag_word_cloud.tag_word_cloud.create_wordcloud(word_dict, mask_path=wc["mask_path"], + width=wc["width"], height=wc["height"], prefer_horizontal=wc["prefer_horizontal"], background_color=wc["background_color"], min_font_size=wc["min_font_size"], max_font_size=wc["max_font_size"], contour_width=wc["contour_width"], contour_color=wc["contour_color"], font_path=wc["font_path"]) - svg_data = word_cloud_to_svg(tag_wc) + svg_data = tag_word_cloud.word_cloud_to_svg(tag_wc) cloud_filename = os.path.realpath(os.path.join(save_dir, self.sum_op.summary_name, self.sum_op.summary_name + '_word_cloud.svg')) with open(cloud_filename, "w") as outfile: diff --git a/hed/tools/remodeling/operations/summarize_hed_validation_op.py b/hed/tools/remodeling/operations/summarize_hed_validation_op.py index 77281aa41..87f8ac086 100644 --- a/hed/tools/remodeling/operations/summarize_hed_validation_op.py +++ b/hed/tools/remodeling/operations/summarize_hed_validation_op.py @@ -1,7 +1,8 @@ """ Validate the HED tags in a dataset and report errors. """ import os -from hed.errors import ErrorSeverity, ErrorHandler, get_printable_issue_string +from hed.errors import error_reporter +from hed.errors import error_types from hed.models.sidecar import Sidecar from hed.models.tabular_input import TabularInput from hed.tools.remodeling.operations.base_op import BaseOp @@ -160,8 +161,8 @@ def update_summary(self, new_info): input_data = TabularInput(new_info['df'], sidecar=sidecar) issues = input_data.validate(new_info['schema']) if not self.sum_op.check_for_warnings: - issues = ErrorHandler.filter_issues_by_severity(issues, ErrorSeverity.ERROR) - issues = [get_printable_issue_string([issue], skip_filename=True) for issue in issues] + issues = error_reporter.ErrorHandler.filter_issues_by_severity(issues, error_types.ErrorSeverity.ERROR) + issues = [error_reporter.get_printable_issue_string([issue], skip_filename=True) for issue in issues] results['event_issues'][new_info["name"]] = issues results['total_event_issues'] = len(issues) self.summary_dict[new_info["name"]] = results @@ -345,12 +346,13 @@ def _get_sidecar_results(sidecar, new_info, check_for_warnings): results["sidecar_files"].append(sidecar.name) results["sidecar_issues"][sidecar.name] = [] sidecar_issues = sidecar.validate(new_info.get('schema', None)) - filtered_issues = ErrorHandler.filter_issues_by_severity(sidecar_issues, ErrorSeverity.ERROR) + filtered_issues = error_reporter.ErrorHandler.filter_issues_by_severity(sidecar_issues, + error_types.ErrorSeverity.ERROR) if filtered_issues: results["sidecar_had_issues"] = True if not check_for_warnings: sidecar_issues = filtered_issues - str_issues = [get_printable_issue_string([issue], skip_filename=True) for issue in sidecar_issues] + str_issues = [error_reporter.get_printable_issue_string([issue], skip_filename=True) for issue in sidecar_issues] results['sidecar_issues'][sidecar.name] = str_issues results['total_sidecar_issues'] = len(sidecar_issues) return results diff --git a/hed/tools/remodeling/operations/summarize_sidecar_from_events_op.py b/hed/tools/remodeling/operations/summarize_sidecar_from_events_op.py index 4f0eedcd8..6ef84acd0 100644 --- a/hed/tools/remodeling/operations/summarize_sidecar_from_events_op.py +++ b/hed/tools/remodeling/operations/summarize_sidecar_from_events_op.py @@ -1,7 +1,7 @@ """ Create a JSON sidecar from column values in a collection of tabular files. """ import json -from hed.tools import TabularSummary +from hed.tools.analysis.tabular_summary import TabularSummary from hed.tools.remodeling.operations.base_op import BaseOp from hed.tools.remodeling.operations.base_summary import BaseSummary diff --git a/hed/tools/remodeling/remodeler_validator.py b/hed/tools/remodeling/remodeler_validator.py index 0723582b6..216d1df4a 100644 --- a/hed/tools/remodeling/remodeler_validator.py +++ b/hed/tools/remodeling/remodeler_validator.py @@ -1,6 +1,6 @@ """ Validator for remodeler input files. """ +import jsonschema from copy import deepcopy -from jsonschema import Draft202012Validator from hed.tools.remodeling.operations.valid_operations import valid_operations @@ -103,7 +103,7 @@ class RemodelerValidator: def __init__(self): """ Constructor for remodeler Validator. """ self.schema = self._construct_schema() # The compiled json schema against which remodeler files are validated. - self.validator = Draft202012Validator(self.schema) # The instantiated json schema validator. + self.validator = jsonschema.Draft202012Validator(self.schema) # The instantiated json schema validator. def validate(self, operations): """ Validate remodeler operations against the json schema specification and specific op requirements. diff --git a/hed/tools/visualization/tag_word_cloud.py b/hed/tools/visualization/tag_word_cloud.py index 083e1b7aa..fefef35fa 100644 --- a/hed/tools/visualization/tag_word_cloud.py +++ b/hed/tools/visualization/tag_word_cloud.py @@ -2,9 +2,9 @@ import numpy as np from PIL import Image -from hed.errors import HedFileError -from hed.tools.visualization.word_cloud_util import default_color_func, WordCloud, generate_contour_svg -import matplotlib.font_manager as fm +from hed.errors.exceptions import HedFileError +from hed.tools.visualization import word_cloud_util +from wordcloud import WordCloud def create_wordcloud(word_dict, mask_path=None, background_color=None, width=400, height=300, **kwargs): @@ -40,7 +40,7 @@ def create_wordcloud(word_dict, mask_path=None, background_color=None, width=400 kwargs.setdefault('contour_width', 3) kwargs.setdefault('contour_color', 'black') kwargs.setdefault('prefer_horizontal', 0.75) - kwargs.setdefault('color_func', default_color_func) + kwargs.setdefault('color_func', word_cloud_util.default_color_func) kwargs.setdefault('relative_scaling', 1) kwargs.setdefault('max_font_size', height / 20) kwargs.setdefault('min_font_size', 8) @@ -68,7 +68,7 @@ def word_cloud_to_svg(wc): """ svg_string = wc.to_svg() svg_string = svg_string.replace("fill:", "fill:rgb") - svg_string = svg_string.replace("", generate_contour_svg(wc, wc.width, wc.height) + "") + svg_string = svg_string.replace("", word_cloud_util.generate_contour_svg(wc, wc.width, wc.height) + "") return svg_string diff --git a/hed/tools/visualization/word_cloud_util.py b/hed/tools/visualization/word_cloud_util.py index d33d06e7f..8026f0d40 100644 --- a/hed/tools/visualization/word_cloud_util.py +++ b/hed/tools/visualization/word_cloud_util.py @@ -5,7 +5,7 @@ import numpy as np from PIL import Image, ImageFilter from matplotlib import cm -from wordcloud import WordCloud +import wordcloud as wcloud def generate_contour_svg(wc, width, height): @@ -88,7 +88,7 @@ def _draw_contour(wc, img: Image): # Replace WordCloud function with one that can handle transparency -WordCloud._draw_contour = _draw_contour +wcloud.WordCloud._draw_contour = _draw_contour def _numpy_to_svg(contour, radius=1, color="black"): diff --git a/hed/validator/hed_validator.py b/hed/validator/hed_validator.py index 26f913935..22d83e715 100644 --- a/hed/validator/hed_validator.py +++ b/hed/validator/hed_validator.py @@ -6,11 +6,11 @@ """ import re from hed.errors.error_types import ValidationErrors, DefinitionErrors -from hed.errors.error_reporter import ErrorHandler, check_for_any_errors +from hed.errors import error_reporter from hed.validator.def_validator import DefValidator from hed.validator.tag_util import UnitValueValidator, CharValidator, StringValidator, TagValidator, GroupValidator -from hed.schema import HedSchema +from hed.schema.hed_schema import HedSchema class HedValidator: @@ -52,11 +52,11 @@ def validate(self, hed_string, allow_placeholders, error_handler=None): issues (list of dict): A list of issues for hed string """ if not error_handler: - error_handler = ErrorHandler() + error_handler = error_reporter.ErrorHandler() issues = [] issues += self.run_basic_checks(hed_string, allow_placeholders=allow_placeholders) error_handler.add_context_and_filter(issues) - if check_for_any_errors(issues): + if error_reporter.check_for_any_errors(issues): return issues issues += self.run_full_string_checks(hed_string) error_handler.add_context_and_filter(issues) @@ -65,14 +65,14 @@ def validate(self, hed_string, allow_placeholders, error_handler=None): def run_basic_checks(self, hed_string, allow_placeholders): issues = [] issues += self._run_hed_string_validators(hed_string, allow_placeholders) - if check_for_any_errors(issues): + if error_reporter.check_for_any_errors(issues): return issues if hed_string == "n/a": return issues for tag in hed_string.get_all_tags(): issues += self._run_validate_tag_characters(tag, allow_placeholders=allow_placeholders) issues += hed_string._calculate_to_canonical_forms(self._hed_schema) - if check_for_any_errors(issues): + if error_reporter.check_for_any_errors(issues): return issues issues += self._validate_individual_tags_in_hed_string(hed_string, allow_placeholders=allow_placeholders) issues += self._def_validator.validate_def_tags(hed_string, self) @@ -132,10 +132,10 @@ def check_tag_formatting(self, original_tag): """ validation_issues = [] for match in self.pattern_doubleslash.finditer(original_tag.org_tag): - validation_issues += ErrorHandler.format_error(ValidationErrors.NODE_NAME_EMPTY, - tag=original_tag, - index_in_tag=match.start(), - index_in_tag_end=match.end()) + validation_issues += error_reporter.ErrorHandler.format_error(ValidationErrors.NODE_NAME_EMPTY, + tag=original_tag, + index_in_tag=match.start(), + index_in_tag_end=match.end()) return validation_issues @@ -195,7 +195,8 @@ def _validate_individual_tags_in_hed_string(self, hed_string_obj, allow_placehol is_definition = group in all_definition_groups for hed_tag in group.tags(): if not self._definitions_allowed and hed_tag.short_base_tag == DefTagNames.DEFINITION_KEY: - validation_issues += ErrorHandler.format_error(DefinitionErrors.BAD_DEFINITION_LOCATION, hed_tag) + validation_issues += error_reporter.ErrorHandler.format_error( + DefinitionErrors.BAD_DEFINITION_LOCATION, hed_tag) # todo: unclear if this should be restored at some point # if hed_tag.expandable and not hed_tag.expanded: # for tag in hed_tag.expandable.get_all_tags(): diff --git a/hed/validator/onset_validator.py b/hed/validator/onset_validator.py index dfd2b7cd4..947328a1d 100644 --- a/hed/validator/onset_validator.py +++ b/hed/validator/onset_validator.py @@ -1,3 +1,5 @@ +""" Validates the onset/offset conditions. """ + from hed.models.model_constants import DefTagNames from hed.errors.error_reporter import ErrorHandler from hed.errors.error_types import TemporalErrors diff --git a/hed/validator/sidecar_validator.py b/hed/validator/sidecar_validator.py index 462423b54..8e8189b53 100644 --- a/hed/validator/sidecar_validator.py +++ b/hed/validator/sidecar_validator.py @@ -3,13 +3,13 @@ import itertools from hed.errors import ErrorHandler, ErrorContext, SidecarErrors, DefinitionErrors, ColumnErrors -from hed.models import ColumnType -from hed import HedString +from hed.models.column_mapper import ColumnType +from hed.models.hed_string import HedString from hed.models.column_metadata import ColumnMetadata from hed.errors.error_reporter import sort_issues from hed.models.model_constants import DefTagNames from hed.errors.error_reporter import check_for_any_errors -from hed.models.df_util import replace_ref +from hed.models import df_util # todo: Add/improve validation for definitions being in known columns(right now it just assumes they aren't) @@ -97,7 +97,7 @@ def validate(self, sidecar, extra_def_dicts=None, name=None, error_handler=None) ref_dict = dict(zip(refs, combination)) modified_string = hed_string for ref in refs: - modified_string = replace_ref(modified_string, f"{{{ref}}}", ref_dict[ref]) + modified_string = df_util.replace_ref(modified_string, f"{{{ref}}}", ref_dict[ref]) hed_string_obj = HedString(modified_string, hed_schema=self._schema, def_dict=sidecar_def_dict) error_handler.push_error_context(ErrorContext.HED_STRING, hed_string_obj) diff --git a/hed/validator/spreadsheet_validator.py b/hed/validator/spreadsheet_validator.py index 1e07af111..c684f9d4b 100644 --- a/hed/validator/spreadsheet_validator.py +++ b/hed/validator/spreadsheet_validator.py @@ -1,14 +1,14 @@ import copy -from hed import BaseInput -from hed.errors import ErrorHandler, ValidationErrors, ErrorContext -from hed.errors.error_types import ColumnErrors -from hed.models import ColumnType -from hed import HedString +from hed.models.base_input import BaseInput +from hed.errors.error_types import ColumnErrors, ErrorContext, ValidationErrors +from hed.errors.error_reporter import ErrorHandler +from hed.models.column_mapper import ColumnType +from hed.models.hed_string import HedString from hed.errors.error_reporter import sort_issues, check_for_any_errors from hed.validator.onset_validator import OnsetValidator from hed.validator.hed_validator import HedValidator -from hed.models.df_util import sort_dataframe_by_onsets, split_delay_tags +from hed.models import df_util PANDAS_COLUMN_PREFIX_TO_IGNORE = "Unnamed: " @@ -59,11 +59,11 @@ def validate(self, data, def_dicts=None, name=None, error_handler=None): if data.needs_sorting: data_new = copy.deepcopy(data) - data_new._dataframe = sort_dataframe_by_onsets(data.dataframe) + data_new._dataframe = df_util.sort_dataframe_by_onsets(data.dataframe) issues += error_handler.format_error_with_context(ValidationErrors.ONSETS_OUT_OF_ORDER) data = data_new - onsets = split_delay_tags(data.series_a, self._schema, data.onsets) + onsets = df_util.split_delay_tags(data.series_a, self._schema, data.onsets) df = data.dataframe_a self._hed_validator = HedValidator(self._schema, def_dicts=def_dicts) diff --git a/hed/validator/tag_util/class_util.py b/hed/validator/tag_util/class_util.py index c870f0ebf..efdc90c49 100644 --- a/hed/validator/tag_util/class_util.py +++ b/hed/validator/tag_util/class_util.py @@ -2,8 +2,8 @@ import datetime import re -from hed.schema.schema_validation_util import get_allowed_characters, get_problem_indexes -from hed.schema.schema_validation_util_deprecated import _get_disallowed_character_indexes +from hed.schema import schema_validation_util +from hed.schema import schema_validation_util_deprecated from hed.errors.error_reporter import ErrorHandler from hed.errors.error_types import ValidationErrors @@ -114,10 +114,10 @@ def _get_tag_problem_indexes(original_tag, stripped_value, validate_characters): return indexes if validate_characters: - allowed_characters = get_allowed_characters(original_tag.value_classes.values()) - return get_problem_indexes(stripped_value, allowed_characters, index_adj=start_index) + allowed_characters = schema_validation_util.get_allowed_characters(original_tag.value_classes.values()) + return schema_validation_util.get_problem_indexes(stripped_value, allowed_characters, index_adj=start_index) else: - return _get_disallowed_character_indexes(stripped_value, start_index) + return schema_validation_util_deprecated._get_disallowed_character_indexes(stripped_value, start_index) def _check_value_class(self, original_tag, stripped_value, report_as, error_code=None, index_offset=0): """ Return any issues found if this is a value tag, diff --git a/hed/validator/tag_util/group_util.py b/hed/validator/tag_util/group_util.py index cc32970eb..738ebf09c 100644 --- a/hed/validator/tag_util/group_util.py +++ b/hed/validator/tag_util/group_util.py @@ -1,9 +1,9 @@ -""" Validation o the HED tags as strings. """ +""" Validation of the HED tags as strings. """ from hed.errors.error_reporter import ErrorHandler from hed.models.model_constants import DefTagNames -from hed.schema import HedKey -from hed.models import HedTag +from hed.schema.hed_schema_constants import HedKey +from hed.models.hed_tag import HedTag from hed.errors.error_types import ValidationErrors, TemporalErrors diff --git a/hed/validator/tag_util/string_util.py b/hed/validator/tag_util/string_util.py index aea9b843e..d5639807f 100644 --- a/hed/validator/tag_util/string_util.py +++ b/hed/validator/tag_util/string_util.py @@ -1,3 +1,5 @@ +""" Utilities supporting the validation of HED strings. """ + from hed.errors.error_reporter import ErrorHandler from hed.errors.error_types import ValidationErrors diff --git a/hed/validator/tag_util/tag_util.py b/hed/validator/tag_util/tag_util.py index f85bd3940..fd292117a 100644 --- a/hed/validator/tag_util/tag_util.py +++ b/hed/validator/tag_util/tag_util.py @@ -1,11 +1,8 @@ -""" -This module is used to validate the HED tags as strings. - -""" +""" Utilities supporting validation of HED tags as strings. """ import re from hed.errors.error_reporter import ErrorHandler -from hed.schema import HedKey +from hed.schema.hed_schema_constants import HedKey from hed.errors.error_types import ValidationErrors diff --git a/requirements.txt b/requirements.txt index ff3ca85e2..217e1642b 100644 --- a/requirements.txt +++ b/requirements.txt @@ -5,7 +5,7 @@ matplotlib>=3 numpy>=1.21.6 openpyxl>=3.1.0 pandas>=1.3.5 -pillow>=10.2.0 +pillow>=9.5.0 portalocker>=2.7.0 semantic_version>=2.10.0 wordcloud>=1.9.3 diff --git a/tests/models/test_base_input.py b/tests/models/test_base_input.py index 9b9e9e532..ce83ca4ff 100644 --- a/tests/models/test_base_input.py +++ b/tests/models/test_base_input.py @@ -2,13 +2,15 @@ import unittest import os import shutil -from hed import Sidecar, load_schema_version -from hed import BaseInput, TabularInput +from hed.models.sidecar import Sidecar +from hed.schema.hed_schema_io import load_schema_version +from hed.models.base_input import BaseInput +from hed.models.tabular_input import TabularInput from hed.models.column_mapper import ColumnMapper -from hed.models import DefinitionDict +from hed.models.definition_dict import DefinitionDict from hed import schema -from hed import HedFileError -from hed.errors import ErrorContext, ValidationErrors +from hed.errors.exceptions import HedFileError +from hed.errors.error_types import ErrorContext, ValidationErrors import pandas as pd diff --git a/tests/tools/analysis/test_annotation_util.py b/tests/tools/analysis/test_annotation_util.py index e1612da37..d7bc2de3a 100644 --- a/tests/tools/analysis/test_annotation_util.py +++ b/tests/tools/analysis/test_annotation_util.py @@ -2,18 +2,16 @@ import io import json import unittest -from pandas import DataFrame +import numpy as np +from pandas import DataFrame, Series from hed import schema as hedschema -from hed.errors import HedFileError +from hed.errors.exceptions import HedFileError from hed.models.sidecar import Sidecar from hed.models.hed_string import HedString from hed.models.tabular_input import TabularInput -from hed.tools.analysis.annotation_util import check_df_columns, df_to_hed, extract_tags, \ - hed_to_df, merge_hed_dict, strs_to_sidecar, str_to_tabular, to_strlist -from hed.tools.analysis.annotation_util import _flatten_cat_col, _flatten_val_col, _get_value_entry, _tag_list_to_str, \ - _update_cat_dict, generate_sidecar_entry +from hed.tools.analysis import annotation_util from hed.tools.analysis.tabular_summary import TabularSummary -from hed.tools.util.io_util import get_file_list +from hed.tools.util import io_util # noinspection PyBroadException @@ -60,35 +58,35 @@ def setUpClass(cls): cls.sidecar_facesm = json.load(fp) def test_check_df_columns(self): - df1 = hed_to_df(self.sidecar1a) - missing1 = check_df_columns(df1) + df1 = annotation_util.hed_to_df(self.sidecar1a) + missing1 = annotation_util.check_df_columns(df1) self.assertFalse(missing1) df2 = df1.drop('column_value', axis=1) - missing2 = check_df_columns(df2, ('column_name', 'column_value')) + missing2 = annotation_util.check_df_columns(df2, ('column_name', 'column_value')) self.assertTrue(missing2, "check_df_column has non-empty return if items missing") self.assertEqual(len(missing2), 1, "check_df_column finds correct number of missing items") def test_extract_tags_no_tag(self): - remainder0, extracted0 = extract_tags("", 'Description/') + remainder0, extracted0 = annotation_util.extract_tags("", 'Description/') self.assertFalse(remainder0, "extract_tags should have empty remainder if empty string") self.assertFalse(extracted0, "extract_tags should have empty extracted if empty string") str1 = "Bear, Description, Junk" - remainder1, extracted1 = extract_tags(str1, 'Description/') + remainder1, extracted1 = annotation_util.extract_tags(str1, 'Description/') self.assertEqual(remainder1, str1, "extract_tags should return same string if no extracted tag") self.assertIsInstance(extracted1, list, "extract_tags should return an empty list list") self.assertFalse(extracted1, "extract_tags return an empty extracted list if no tag in string ") def test_extract_tags_with_remainder(self): str2 = "Bear, Description/Pluck this leaf., Junk" - remainder2, extracted2 = extract_tags(str2, 'Description/') + remainder2, extracted2 = annotation_util.extract_tags(str2, 'Description/') self.assertEqual(remainder2, "Bear, Junk", "extract_tags should return the right string") self.assertIsInstance(extracted2, list, "extract_tags should return a list") self.assertEqual(len(extracted2), 1, "extract_tags should return a list of the right length") self.assertEqual(extracted2[0], "Description/Pluck this leaf.", "extract_tag return right item ") str3 = "Description/Pluck this leaf., Junk, Bells" - remainder3, extracted3 = extract_tags(str3, 'Description/') + remainder3, extracted3 = annotation_util.extract_tags(str3, 'Description/') self.assertEqual(remainder3, "Junk, Bells", "extract_tags should return the right remainder when at beginning") self.assertIsInstance(extracted3, list, "extract_tags should return a list when at beginning") self.assertEqual(len(extracted3), 1, "extract_tags should return a list of the right length when at beginning") @@ -96,7 +94,7 @@ def test_extract_tags_with_remainder(self): "extract_tags return right item when at beginning") str4 = "Junk, Bells, Description/Pluck this leaf." - remainder4, extracted4 = extract_tags(str4, 'Description/') + remainder4, extracted4 = annotation_util.extract_tags(str4, 'Description/') self.assertEqual(remainder4, "Junk, Bells", "extract_tags should return the right remainder when at end") self.assertIsInstance(extracted4, list, "extract_tags should return a list when at beginning") self.assertEqual(len(extracted4), 1, "extract_tags should return a list of the right length when at end") @@ -105,7 +103,7 @@ def test_extract_tags_with_remainder(self): def extract_tag_multiple_matches(self): str5 = "Bear, Description/Pluck this leaf., Junk, Description/Another description." - remainder5, extracted5 = extract_tags(str5, 'Description/') + remainder5, extracted5 = annotation_util.extract_tags(str5, 'Description/') self.assertEqual(remainder5, "Bear, Junk", "extract_tags should return the right string") self.assertIsInstance(extracted5, list, "extract_tags should return a list") self.assertEqual(len(extracted5), 2, "extract_tags should return a list of the right length") @@ -113,7 +111,7 @@ def extract_tag_multiple_matches(self): self.assertEqual(extracted5[1], "Description/Another description.", "extract_tags return right item ") str6 = "Bear, ((Description/Pluck this leaf., Junk), Description/Another description.)" - remainder6, extracted6 = extract_tags(str6, 'Description/') + remainder6, extracted6 = annotation_util.extract_tags(str6, 'Description/') self.assertEqual(remainder6, "Bear, ((Junk))", "extract_tags should return the right string when parens") self.assertIsInstance(extracted6, list, "extract_tags should return a list when parens") self.assertEqual(len(extracted6), 2, "extract_tags should return a list of the right length when parens") @@ -123,7 +121,7 @@ def extract_tag_multiple_matches(self): def test_extract_tag_with_parens(self): str7 = "Bear, ((Informational-property/Description/Pluck this leaf., Junk), Description/Another description.)" - remainder7, extracted7 = extract_tags(str7, 'Description/') + remainder7, extracted7 = annotation_util.extract_tags(str7, 'Description/') self.assertEqual(remainder7, "Bear, ((Junk))", "extract_tags should return the right string when parens") self.assertIsInstance(extracted7, list, "extract_tags should return a list when parens") self.assertEqual(len(extracted7), 2, "extract_tags should return a list of the right length when parens") @@ -133,12 +131,12 @@ def test_extract_tag_with_parens(self): "extract_tags return right item when parens") def test_df_to_hed(self): - df1 = hed_to_df(self.sidecar1a, col_names=None) - hed1 = df_to_hed(df1) + df1 = annotation_util.hed_to_df(self.sidecar1a, col_names=None) + hed1 = annotation_util.df_to_hed(df1) self.assertIsInstance(hed1, dict, "df_to_hed should produce a dictionary") self.assertEqual(len(hed1), 1, "df_to_hed ") - df2 = hed_to_df(self.sidecar2b, col_names=None) - hed2 = df_to_hed(df2) + df2 = annotation_util.hed_to_df(self.sidecar2b, col_names=None) + hed2 = annotation_util.df_to_hed(df2) self.assertIsInstance(hed2, dict, "df_to_hed should produce a dictionary") self.assertEqual(len(hed2), 1, "df_to_hed ") @@ -147,42 +145,42 @@ def test_df_to_hed_wrong_format(self): ['event_code', 'sausage', 'this is sausage', 'junk2']] df = DataFrame(data, columns=['column_name', 'column_value', 'description', 'blech']) with self.assertRaises(HedFileError) as context: - df_to_hed(df) + annotation_util.df_to_hed(df) self.assertEqual(context.exception.args[0], 'RequiredColumnsMissing') def test_df_to_hed_nas(self): data = [['event_code', 'baloney', 'n/a', 'n/a'], ['event_code', 'sausage', 'this is sausage', 'n/a']] df = DataFrame(data, columns=['column_name', 'column_value', 'description', 'HED']) - hed1 = df_to_hed(df) + hed1 = annotation_util.df_to_hed(df) self.assertIsInstance(hed1, dict) self.assertIsInstance(hed1['event_code'], dict) self.assertEqual(len(hed1['event_code']), 2) def test_df_to_hed_columns_missing(self): - df1 = hed_to_df(self.sidecar3, col_names=["a", "b"]) - hed1 = df_to_hed(df1) + df1 = annotation_util.hed_to_df(self.sidecar3, col_names=["a", "b"]) + hed1 = annotation_util.df_to_hed(df1) self.assertIsInstance(hed1, dict, "df_to_hed should return a dictionary two columns") self.assertEqual(len(hed1), 2, "df_to_hed should have two keys when two columns") - df2 = hed_to_df(self.sidecar3, col_names=["a"]) - hed2 = df_to_hed(df2) + df2 = annotation_util.hed_to_df(self.sidecar3, col_names=["a"]) + hed2 = annotation_util.df_to_hed(df2) self.assertIsInstance(hed2, dict, "df_to_hed should return a dictionary one columns") self.assertEqual(len(hed2), 1, "df_to_hed should have one keys when one columns") - df3 = hed_to_df(self.sidecar3, col_names=[]) - hed3 = df_to_hed(df3) + df3 = annotation_util.hed_to_df(self.sidecar3, col_names=[]) + hed3 = annotation_util.df_to_hed(df3) self.assertIsInstance(hed3, dict, "df_to_hed should return a dictionary three columns") self.assertEqual(len(hed3), 3, "df_to_hed should have three keys when three columns") def test_df_to_hed_extra_col_names(self): - df1 = hed_to_df(self.sidecar3, col_names=["a", "b", "c", "d"]) - hed1 = df_to_hed(df1) + df1 = annotation_util.hed_to_df(self.sidecar3, col_names=["a", "b", "c", "d"]) + hed1 = annotation_util.df_to_hed(df1) self.assertIsInstance(hed1, dict, "df_to_hed should return a dictionary three columns") self.assertEqual(len(hed1), 3, "df_to_hed should have three keys when three columns match") def test_generate_sidecar_entry(self): - entry1 = generate_sidecar_entry('event_type', column_values=['apple', 'banana', 'n/a']) + entry1 = annotation_util.generate_sidecar_entry('event_type', column_values=['apple', 'banana', 'n/a']) self.assertIsInstance(entry1, dict, "generate_sidecar_entry should be a dictionary when column values") self.assertEqual(len(entry1), 3, "generate_sidecar_entry should have 3 entries when column values") self.assertIn('Description', entry1, "generate_sidecar_entry should have Description when column values") @@ -190,7 +188,7 @@ def test_generate_sidecar_entry(self): self.assertEqual(len(entry1['HED']), 2, "generate_sidecar_entry should not include n/a in HED") self.assertIn('Levels', entry1, "generate_sidecar_entry should have Levels when column values") self.assertEqual(len(entry1['Levels']), 2, "generate_sidecar_entry should not include n/a in Levels") - entry2 = generate_sidecar_entry('event_type') + entry2 = annotation_util.generate_sidecar_entry('event_type') self.assertIsInstance(entry2, dict, "generate_sidecar_entry should be a dictionary when no column values") self.assertEqual(len(entry2), 2, "generate_sidecar_entry should have 2 entries when no column values") self.assertIn('Description', entry2, "generate_sidecar_entry should have a Description when no column values") @@ -198,8 +196,20 @@ def test_generate_sidecar_entry(self): self.assertIsInstance(entry2['HED'], str, "generate_sidecar_entry HED entry should be str when no column values") + def test_series_to_factor(self): + series1 = Series([1.0, 2.0, 3.0, 4.0]) + factor1 = annotation_util.series_to_factor(series1) + self.assertEqual(len(series1), len(factor1)) + self.assertEqual(sum(factor1), len(factor1)) + series2 = Series(['a', '', None, np.NAN, 'n/a']) + factor2 = annotation_util.series_to_factor(series2) + self.assertEqual(len(series2), len(factor2)) + self.assertEqual(sum(factor2), 1) + + def test_generate_sidecar_entry_non_letters(self): - entry1 = generate_sidecar_entry('my !#$-123_10', column_values=['apple 1', '@banana', 'grape%cherry&']) + entry1 = annotation_util.generate_sidecar_entry('my !#$-123_10', + column_values=['apple 1', '@banana', 'grape%cherry&']) self.assertIsInstance(entry1, dict, "generate_sidecar_entry is a dictionary when column values and special chars.") self.assertIn('HED', entry1, @@ -207,25 +217,25 @@ def test_generate_sidecar_entry_non_letters(self): hed_entry1 = entry1['HED'] self.assertEqual(hed_entry1['apple 1'], '(Label/my_-123_10, Label/apple_1)', "generate_sidecar_entry HED entry should convert labels correctly when column values") - entry2 = generate_sidecar_entry('my !#$-123_10') + entry2 = annotation_util.generate_sidecar_entry('my !#$-123_10') self.assertIsInstance(entry2, dict, "generate_sidecar_entry is a dictionary when no column values and special chars.") self.assertEqual(entry2['HED'], '(Label/my_-123_10, Label/#)', "generate_sidecar_entry HED entry has correct label when no column values and special chars.") def test_hed_to_df(self): - df1a = hed_to_df(self.sidecar1a, col_names=None) + df1a = annotation_util.hed_to_df(self.sidecar1a, col_names=None) self.assertIsInstance(df1a, DataFrame) self.assertEqual(len(df1a), 1) - df1a = hed_to_df(self.sidecar1a, col_names=["a"]) + df1a = annotation_util.hed_to_df(self.sidecar1a, col_names=["a"]) self.assertIsInstance(df1a, DataFrame) self.assertEqual(len(df1a), 0) - df2a = hed_to_df(self.sidecar2a) + df2a = annotation_util.hed_to_df(self.sidecar2a) self.assertIsInstance(df2a, DataFrame) self.assertEqual(len(df2a), 2) def test_hed_to_df_with_definitions(self): - df1 = hed_to_df(self.sidecar_facesm) + df1 = annotation_util.hed_to_df(self.sidecar_facesm) self.assertIsInstance(df1, DataFrame) self.assertEqual(len(df1), 12) remainder = "(Definition/Scrambled-face-cond, (Condition-variable/Face-type, (Image, (Face, Disordered))))" @@ -239,60 +249,60 @@ def test_hed_to_df_to_hed(self): side1 = Sidecar(files=self.json_path, name="sidecar_face.json") issues1 = side1.validate(self.hed_schema) self.assertFalse(issues1, "hed_to_df_to_hed is starting with a valid JSON sidecar") - df1 = hed_to_df(self.sidecar_face) + df1 = annotation_util.hed_to_df(self.sidecar_face) self.assertIsInstance(df1, DataFrame, "hed_to_df_to_hed starting sidecar can be converted to df") - hed2 = df_to_hed(df1, description_tag=True) + hed2 = annotation_util.df_to_hed(df1, description_tag=True) side2 = Sidecar(files=io.StringIO(json.dumps(hed2)), name='JSON_Sidecar2') issues2 = side2.validate(self.hed_schema) self.assertFalse(issues2, "hed_to_df_to_hed is valid after conversion back and forth with description True") - hed3 = df_to_hed(df1, description_tag=False) + hed3 = annotation_util.df_to_hed(df1, description_tag=False) side3 = Sidecar(files=io.StringIO(json.dumps(hed3)), name='JSON_Sidecar2') issues3 = side3.validate(self.hed_schema) self.assertFalse(issues3, "hed_to_df_to_hed is valid after conversion back and forth with description False") def test_merge_hed_dict_cat_col(self): - df2a = hed_to_df(self.sidecar2a, col_names=None) - df2b = hed_to_df(self.sidecar2b, col_names=None) - df2c = hed_to_df(self.sidecar2c, col_names=None) - hed2a = df_to_hed(df2a) + df2a = annotation_util.hed_to_df(self.sidecar2a, col_names=None) + df2b = annotation_util.hed_to_df(self.sidecar2b, col_names=None) + df2c = annotation_util.hed_to_df(self.sidecar2c, col_names=None) + hed2a = annotation_util.df_to_hed(df2a) self.assertIsInstance(hed2a, dict) - hed2b = df_to_hed(df2b) + hed2b = annotation_util.df_to_hed(df2b) self.assertIsInstance(hed2b, dict) - hed2c = df_to_hed(df2c) + hed2c = annotation_util.df_to_hed(df2c) self.assertIsInstance(hed2c, dict) # TODO: test of categorical columns not yet written def test_merge_hed_dict_value_col(self): - df1a = hed_to_df(self.sidecar1a, col_names=None) - df1b = hed_to_df(self.sidecar1b, col_names=None) - hed1a = df_to_hed(df1a) - hed1b = df_to_hed(df1b) + df1a = annotation_util.hed_to_df(self.sidecar1a, col_names=None) + df1b = annotation_util.hed_to_df(self.sidecar1b, col_names=None) + hed1a = annotation_util.df_to_hed(df1a) + hed1b = annotation_util.df_to_hed(df1b) self.assertEqual(len(df1a), 1, "merge_hed_dict should have the right length before merge") self.assertEqual(len(self.sidecar1a), 2, "merge_hed_dict should have the right length before merge") - merge_hed_dict(self.sidecar1a, hed1a) + annotation_util.merge_hed_dict(self.sidecar1a, hed1a) self.assertEqual(len(self.sidecar1a), 2, "merge_hed_dict should have the right length after merge") self.assertIsInstance(self.sidecar1a['b']['HED'], str, "merge_hed_dict preserve a value key") self.assertNotIn('Description', self.sidecar1a['b'], "merge_hed_dict should not have description when n/a") - merge_hed_dict(self.sidecar1b, hed1a) + annotation_util.merge_hed_dict(self.sidecar1b, hed1a) self.assertIsInstance(self.sidecar1b['b']['HED'], str, "merge_hed_dict preserve a value key") self.assertIn('Description', self.sidecar1b['b'], "merge_hed_dict should not have description when n/a") - merge_hed_dict(self.sidecar1b, hed1b) + annotation_util.merge_hed_dict(self.sidecar1b, hed1b) self.assertIn('Description', self.sidecar1b['b'], "merge_hed_dict should not have description when n/a") def test_merge_hed_dict_full(self): exclude_dirs = ['stimuli'] skip_columns = ["onset", "duration", "sample", "trial", "response_time"] value_columns = ["rep_lag", "stim_file", "value"] - event_files = get_file_list(self.bids_root_path, extensions=[".tsv"], name_suffix="_events", + event_files = io_util.get_file_list(self.bids_root_path, extensions=[".tsv"], name_suffix="_events", exclude_dirs=exclude_dirs) value_sum = TabularSummary(value_cols=value_columns, skip_cols=skip_columns) value_sum.update(event_files) sidecar_template = value_sum.extract_sidecar_template() - example_spreadsheet = hed_to_df(sidecar_template) - spreadsheet_sidecar = df_to_hed(example_spreadsheet, description_tag=False) + example_spreadsheet = annotation_util.hed_to_df(sidecar_template) + spreadsheet_sidecar = annotation_util.df_to_hed(example_spreadsheet, description_tag=False) example_sidecar = {} self.assertEqual(0, len(example_sidecar), 'merge_hed_dict input is empty for this test') - merge_hed_dict(example_sidecar, spreadsheet_sidecar) + annotation_util.merge_hed_dict(example_sidecar, spreadsheet_sidecar) self.assertEqual(6, len(example_sidecar), 'merge_hed_dict merges with the correct length') def test_strs_to_sidecar(self): @@ -301,36 +311,37 @@ def test_strs_to_sidecar(self): self.assertIsInstance(sidecar_dict, dict) sidecar_str = json.dumps(sidecar_dict) self.assertIsInstance(sidecar_str, str) - sidecar_obj = strs_to_sidecar(sidecar_str) + sidecar_obj = annotation_util.strs_to_sidecar(sidecar_str) self.assertIsInstance(sidecar_obj, Sidecar) def test_strs_to_tabular(self): with open(self.events_path, 'r') as file: events_contents = file.read() - tab_in = str_to_tabular(events_contents, sidecar=self.json_path) + tab_in = annotation_util.str_to_tabular(events_contents, sidecar=self.json_path) self.assertIsInstance(tab_in, TabularInput) def test_to_strlist(self): # schema # list1 = [HedString('Red, Sensory-event', schema)] list1 = ['abc', '', None, 3.24] - str_list1 = to_strlist(list1) + str_list1 = annotation_util.to_strlist(list1) self.assertEqual(len(str_list1), len(list1)) self.assertFalse(str_list1[2]) self.assertEqual(str_list1[3], '3.24') self.assertFalse(str_list1[1]) list2 = [HedString('Red, Sensory-event', self.hed_schema), None, HedString('', self.hed_schema)] - str_list2 = to_strlist(list2) + str_list2 = annotation_util.to_strlist(list2) self.assertEqual(len(str_list2), len(list2)) self.assertFalse(str_list2[1]) self.assertEqual(str_list2[0], 'Red,Sensory-event') self.assertEqual(str_list2[2], '') + def test_flatten_cat_col(self): col1 = self.sidecar2c["a"] col2 = self.sidecar2c["b"] try: - _flatten_cat_col("a", col1) + annotation_util._flatten_cat_col("a", col1) except KeyError: pass except Exception: @@ -338,7 +349,7 @@ def test_flatten_cat_col(self): else: self.fail("_flatten_cat_col should have thrown a KeyError exception when no HED key") - keys2, values2, descriptions2, tags2 = _flatten_cat_col("b", col2) + keys2, values2, descriptions2, tags2 = annotation_util._flatten_cat_col("b", col2) self.assertEqual(len(keys2), 2, "_flatten_cat_col should have right number of keys if HED") self.assertEqual(len(values2), 2, "_flatten_cat_col should have right number of values if HED") self.assertEqual(len(descriptions2), 2, "_flatten_cat_col should have right number of descriptions if HED") @@ -347,13 +358,13 @@ def test_flatten_cat_col(self): "_flatten_cat_col should use the Description tag if available") def test_flatten_cat_col_only_description(self): - keys, values, descriptions, tags = _flatten_cat_col("event_type", + keys, values, descriptions, tags = annotation_util._flatten_cat_col("event_type", {"HED": {"code1": "Description/Code 1 here."}}) self.assertIsInstance(tags, list) self.assertEqual(tags[0], 'n/a') def test_flatten_val_col_only_description(self): - keys, values, descriptions, tags = _flatten_val_col("response", {"HED": "Description/Code 1 here."}) + keys, values, descriptions, tags = annotation_util._flatten_val_col("response", {"HED": "Description/Code 1 here."}) self.assertEqual(descriptions[0], 'Code 1 here.') self.assertFalse(tags[0]) @@ -361,10 +372,10 @@ def test_flatten_value_col(self): col1 = self.sidecar1a["a"] col2 = self.sidecar1b["b"] with self.assertRaises(KeyError) as context: - _flatten_val_col("a", col1) + annotation_util._flatten_val_col("a", col1) self.assertEqual(context.exception.args[0], 'HED') - keys2, values2, descriptions2, tags2 = _flatten_val_col("b", col2) + keys2, values2, descriptions2, tags2 = annotation_util._flatten_val_col("b", col2) self.assertEqual(len(keys2), 1, "_flatten_val_col should have right number of keys if HED") self.assertEqual(len(values2), 1, "_flatten_val_col should have right number of values if HED") self.assertEqual(len(descriptions2), 1, "_flatten_val_col should have right number of descriptions if HED") @@ -380,49 +391,70 @@ def test_get_row_tags(self): self.assertTrue(col2) def test_get_value_entry(self): - dict1 = _get_value_entry('n/a', 'n/a') + dict1 = annotation_util._get_value_entry('n/a', 'n/a') self.assertFalse(dict1, "_get_value_entry should return empty dict if everything n/a") - dict2 = _get_value_entry('', '') + dict2 = annotation_util._get_value_entry('', '') self.assertFalse(dict2, "_get_value_entry should return empty dict if everything empty") - dict3 = _get_value_entry('Red,Blue', '') + dict3 = annotation_util._get_value_entry('Red,Blue', '') self.assertIn('HED', dict3, "_get_value_entry should have a HED entry when tags but no description") self.assertNotIn('Description', dict3, "_get_value_entry should not have a Description entry when tags but no description") - dict4 = _get_value_entry('Red,Blue,Description/Too bad', '') + dict4 = annotation_util._get_value_entry('Red,Blue,Description/Too bad', '') self.assertIn('HED', dict4, "_get_value_entry should have a HED entry when Description tag") self.assertNotIn('Description', dict4, "_get_value_entry should not have a Description entry when Description tag") - dict5 = _get_value_entry('', 'This is a test') + dict5 = annotation_util._get_value_entry('', 'This is a test') self.assertIn('HED', dict5, "_get_value_entry should have a HED entry when Description used") self.assertIn('Description', dict5, "_get_value_entry should have a Description entry when Description used") - dict6 = _get_value_entry('Red,Blue', 'This is a test') + dict6 = annotation_util._get_value_entry('Red,Blue', 'This is a test') self.assertIn('HED', dict6, "_get_value_entry should have a HED entry when Description used") self.assertEqual(dict6['HED'], 'Red,Blue, Description/This is a test', "_get_value_entry should correct value when Description used for HED tags") self.assertIn('Description', dict6, "_get_value_entry should have a Description entry when Description used") - dict7 = _get_value_entry('Red,Blue', 'This is a test') + dict7 = annotation_util._get_value_entry('Red,Blue', 'This is a test') self.assertIn('HED', dict7, "_get_value_entry should have a HED entry when Description used") self.assertIn('Description', dict7, "_get_value_entry should have a HED entry when Description used") - dict8 = _get_value_entry('', 'This is a test', description_tag=False) + dict8 = annotation_util._get_value_entry('', 'This is a test', description_tag=False) self.assertNotIn('HED', dict8, "_get_value_entry should not have a HED entry when Description not used") self.assertIn('Description', dict8, "_get_value_entry should have Description entry when Description not used") def test_tag_list_to_str(self): ext1 = ["apple", "banana"] - str1 = _tag_list_to_str(ext1) + str1 = annotation_util._tag_list_to_str(ext1) self.assertEqual("apple banana", str1, "tag_list_to_str should return the correct amount when no extra tag") ext2 = ["apple", "Description/banana", "Informational-property/Description/Pear is it."] - str2 = _tag_list_to_str(ext2, "Description/") + str2 = annotation_util._tag_list_to_str(ext2, "Description/") self.assertEqual("apple banana Pear is it.", str2, "tag_list_to_str should return the correct amount when extra tag") + def test_to_factor(self): + series1 = Series([1.0, 2.0, 3.0, 4.0]) + factor1 = annotation_util.to_factor(series1) + self.assertEqual(len(series1), len(factor1)) + self.assertEqual(sum(factor1), len(factor1)) + series2 = Series(['a', '', None, np.NAN, 'n/a']) + factor2 = annotation_util.to_factor(series2) + self.assertEqual(len(series2), len(factor2)) + self.assertEqual(sum(factor2), 1) + data = { + 'Name': ['Alice', '', 'n/a', 1.0], # Contains a space + 'Age': [25, np.NaN, 35, 0] + } + df = DataFrame(data) + factor3 = annotation_util.to_factor(df, column='Name') + self.assertEqual(sum(factor3), 2) + factor4 = annotation_util.to_factor(df) + self.assertEqual(sum(factor4), 2) + with self.assertRaises(HedFileError) as context5: + annotation_util.to_factor(data) + def test_update_cat_dict(self): # TODO: Improve tests cat_dict = self.sidecar_face['event_type'] self.assertNotEqual(cat_dict['HED']['show_face'], 'Blue,Red') - _update_cat_dict(cat_dict, 'show_face', 'Blue,Red', 'n/a', description_tag=True) + annotation_util._update_cat_dict(cat_dict, 'show_face', 'Blue,Red', 'n/a', description_tag=True) self.assertEqual(cat_dict['HED']['show_face'], 'Blue,Red') diff --git a/tests/validator/test_tag_validator.py b/tests/validator/test_tag_validator.py index 3fa6deeb6..e385e1f55 100644 --- a/tests/validator/test_tag_validator.py +++ b/tests/validator/test_tag_validator.py @@ -2,7 +2,7 @@ from hed.errors.error_types import ValidationErrors, DefinitionErrors, TemporalErrors from tests.validator.test_tag_validator_base import TestValidatorBase -from hed import load_schema_version +from hed.schema.hed_schema_io import load_schema_version from functools import partial