Merge branch 'main' of https://github.com/JuliusWelzel/unified_sensor_placement_site

Author: JuliusWelzel

LICENSE.md

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright (c) 2024 the Authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,39 @@
+[![DOI](https://zenodo.org/badge/797952110.svg)](https://doi.org/10.5281/zenodo.14603935)     [![arXiv](https://img.shields.io/badge/arXiv-2412.21159-b31b1b.svg)](https://arxiv.org/abs/2412.21159)
+
+# A Standardized Framework for Sensor Placement in Human Motion Capture
+
+A unified framework for standardizing sensor placement across different sensing modalities and applications in human motion capture and wearable technology.
+
+## Overview
+
+This framework addresses the critical need for standardized sensor placement protocols in human movement analysis and physiological monitoring. While existing standards like SENIAM address specific applications, there has been no comprehensive framework spanning different sensing modalities and applications. Our standard ensures reproducibility and transferability of human movement data across different recording systems and research domains.
+
+## Key Features
+
+- **Precise Anatomical Landmarks**: Comprehensive set of anatomical landmarks chosen for reliability and accessibility
+- **Standardized Coordinate Systems**: Clear definitions for 16 major body segments
+- **Hierarchical Reference Frames**: Structured approach to relating different coordinate systems
+- **Quantified Precision Levels**: Three-tier system for placement accuracy
+- **BIDS/HED Compatible**: Designed to work with existing data sharing standards
+
+## Documentation
+
+- 📖 [Full Paper on arXiv](https://doi.org/10.48550/arXiv.2412.21159)
+- 🌐 [Framework Website](https://human-sensor-placement.github.io)
+- 📊 [Complete Anatomical Table](https://human-sensor-placement.github.io/anatomical_table.html)
+
+## Contributing
+
+We welcome contributions from the research community in several key areas:
+
+- Opinions on the preprint and the proposed framework (the preprint is available on arXiv as well as here in the repository as `paper.md`)
+- Standard vocabulary and communication formats through BIDS, HED, and other specifications
+- Validation studies for inter-operator reliability assessment
+- Mappings between this framework and existing standards (such as SENIAM)
+- Software tools for coordinate calculation and placement visualization
+
+Please submit your suggestions and feedback via the Issues section.
+
+## License
+
+This project is licensed under MIT LICENSE - see the [LICENSE.md](LICENSE.md) file for details.

_quarto.yml

@@ -19,6 +19,3 @@ format:
     grid: 
       body-width: 1500px
       sidebar-width: 50px
-
-
-

anatomical_table.qmd

@@ -20,7 +20,10 @@ Julius has completed his masters in 2019 in Cognitive Neuropsychology in Oldenbu
 
 ![](pics/julius.jpg){ width="50%" class=center }
 
-## Yahya Shirazi
-Yahya is an Assistant Project Scientist at the Swartz center for Computational Neuroscience working hard to make the MOBI world a better place.
+## Seyed (Yahya) Shirazi
+Yahya is an Assistant Project Scientist at the [Swartz center for Computational Neuroscience](https://sccn.ucsd.edu) working hard to make the MOBI world a better place.
 
 ![](pics/yahya.jpg){ width="50%" class=center }
+
+## Lara Godbersen
+Lara is a Master student at the Kiel University. She is interested in the field of cognitive neuroscience and just finished her master thesis with advanced EEG processing.

authors.qmd

@@ -1,126 +1,100 @@
----
-title: "On the Transferability and Accessibility of Human Movement Data"
-format: html
----
-![](pics/logo_placement.png){ width="20%" class=center }
+# A Standardized Framework for Sensor Placement in Human Motion Capture
 
-# Introduction
+::: {.callout-note}
+This website presents a unified framework for sensor placement in human motion capture and wearable applications. For the complete research paper, please visit our preprint on [ArXiv](https://doi.org/10.48550/arXiv.2412.21159).
+:::
 
-Human motion capture encompasses various technologies and techniques to record different modalities of human motion, such as position, speed, or acceleration. These techniques are extensively used in movement science, rehabilitation, sports, and entertainment. However, the heterogeneity of recorded modalities and the varying spatial and temporal resolutions of these recordings pose challenges for the utility and interpretability of motion capture data. This necessitates a clear, unified approach for sensor placement to ensure data transferability and accessibility across different systems.
+## Introduction
 
-Motion capture generally involves acquiring motion-related physical quantities (motion modalities) such as position, speed, and acceleration. The fundamental differences between these quantities highlight the need for different technologies and methods, including passive and active marker-based systems, IMUs, ToF, dot projection, video cameras, and deep learning techniques.
+The proliferation of wearable sensors and monitoring technologies has created an urgent need for standardized sensor placement protocols. While existing standards like SENIAM address specific applications, there is no comprehensive framework that spans different sensing modalities and applications. We present a unified sensor placement standard that ensures reproducibility and transferability of human movement data across different recording systems and research domains.
 
-Each motion capture method has limitations, impacting the interpretability and transferability of data from one modality to another. To address these limitations, we propose a precise annotation of features affecting the quality of motion capture interpretation.
+## Fundamentals
 
-In this manuscript, we will briefly describe the main features of each modality and introduce a set of definitions that we will use throughout. We finally propose a scheme for unified sensor placement annotation with quantifiable levels of precision. We try to align this scheme with the currently available standards for data sharing and annotation, namely the **[Brain Imaging Data Structure (BIDS)](https://bids.neuroimaging.io/)** and the **[Hierarchical Event Descriptors (HED)](https://www.hedtags.org/)**. See [Motion-BIDS](https://bids-specification.readthedocs.io/en/stable/modality-specific-files/motion.html) and definition of body parts in [HED schema browser](https://www.hedtags.org/display_hed.html) for relevant details. 
+### Reference Frames and Coordinate Systems
 
-<style>
-/* Style the button to appear as a box */
-.centered-button {
-  display: flex;
-  justify-content: center;
-  align-items: center;
-  height: 20vh; /* Vertically center */
-  margin: 0; /* Remove default margin */
-}
+A **reference frame** consists of an origin point and a set of axes that define directions in space. In human movement analysis, we encounter multiple reference frames:
 
-.button-box {
-  background-color: #4CAF50; /* Replace with your desired color */
-  color: white;
-  padding: 15px 30px;
-  text-align: center;
-  text-decoration: none;
-  font-size: 16px;
-  font-weight: bold;
-  border-radius: 8px;
-  border: none;
-  cursor: pointer;
-  box-shadow: 0px 4px 6px rgba(0, 0, 0, 0.1);
-  transition: background-color 0.3s, transform 0.3s;
-}
+1. **Global laboratory frame**: The fixed reference frame of the measurement space
+2. **Anatomical frames**: Tied to specific body segments
+3. **Sensor-specific frames**: Related to individual sensor positioning
 
-.button-box:hover {
-  background-color: #45a049; /* Darker green on hover */
-  transform: scale(1.05); /* Slightly enlarges on hover */
-}
-</style>
+A **coordinate system** is fully described by:
+1. The origin relative to which coordinates are expressed
+2. The interpretation of the three axes
+3. The units in which measurements are expressed
 
-<div class="centered-button">
-  <a href="subpage.html" class="button-box">Landmark table</a>
-</div>
+### Hierarchical Structure
 
+Reference frames can have a hierarchical structure, where one frame is nested within another. For example:
+- Torso position within the room frame
+- Arm position relative to the torso
+- Hand position relative to the arm
 
+The **global reference frame** sits at the top of this hierarchy, associated with the space through which the entire body moves.
 
+## Unified Placement Framework
 
-# Types of Motion Capture
-## Optical Motion Capture (OMC)
+### Anatomical Coordinate System
 
-**Optical Motion Capture (OMC)** systems utilize multiple cameras to track the movement of reflective markers placed on a subject's body or objects. These markers reflect light emitted by the cameras, allowing the system to triangulate their positions in three-dimensional space. The cameras record the positions of these markers at high frame rates, capturing data on **marker positions (POS)** and, optionally, **orientation (ORNT)**. Additionally, **velocity (VEL)**, **acceleration (ACCEL)**, and **angular acceleration (ANGACCEL)** data can be derived from the marker positions over time. **Marker placement** should define the type, size, and shape of markers, along with their specific placement on anatomical landmarks, such as joints and limb segments.
+We define precise anatomical coordinate systems for each body segment using palpable landmarks. These definitions ensure consistent interpretation and implementation across different applications.
 
-## Inertial Measurement Units (IMUs)
+::: {.callout-note}
+The complete **anatomical landmark table** with detailed coordinate systems for all body segments is available [here](./anatomical_table.qmd).
+:::
 
-**Inertial Measurement Units (IMUs)** consist of small sensors, including accelerometers, gyroscopes, and sometimes magnetometers, attached to a subject's body. IMUs measure changes in **acceleration (ACCEL)**, **angular acceleration (ANGACCEL)**, **velocity (VEL)**, and **orientation (ORNT)**. They are compact and versatile, making them suitable for wearable applications like sports performance analysis and motion tracking in remote or outdoor environments. **Positioning of the IMU** on the body should include details about the location and orientation, typically described using text and photographs or diagrams showing the sensor's orientation relative to the body part it is attached to.
+### Placement Principles
 
-## Markerless Motion Capture
+Our unified placement scheme follows these core principles:
 
-**Markerless Motion Capture** systems use algorithms to track a subject's movements without physical markers. Cameras capture video footage, which software processes to extract data on **position (POS)**, **orientation (ORNT)**, and sometimes **velocity (VEL)** and **acceleration (ACCEL)**. Markerless motion capture is non-invasive and captures natural movement, making it popular in entertainment, biomechanics, and human-computer interaction. The tracked points' definition is often software-specific, depending on which points the software allows to be tracked.
+1. Sensor placement must be reproducible by a human with defined precision
+2. Placement coordinates relate to anatomical landmarks of the relevant body part
+3. Landmarks define the origin, direction, and limits of axes
+4. Sensor locations are reported as ratios of the axis limits
+5. Placement precision depends on landmarks, axes, and measurement method
 
-# Definitions
+### Precision Levels
 
-## Space
-In BIDS terms, **space** is defined as an artificial frame of reference used to describe different anatomies in a unifying manner (see Appendix VIII). Data collected in studies of physical or virtual motion typically have a reference frame anchored to the physical lab space or the virtual environment.
+We define three levels of placement precision:
 
-## Reference Frame
-A **reference frame** is an abstract coordinate system with a specified origin, orientation, and scale, defined by a set of reference points (Kovalevsky & Mueller, 1989). It broadly describes the type of space or context associated with the data, whether the space is fixed or moving (global or local reference frame), or the identity of the object it moves with. For instance, an anatomical reference frame is fixed to the body and moves as the body moves through space.
+1. **Level 1**: ~10% precision, such as Visual Inspection
+   - Placement defined by visual inspection of body parts and landmarks
+   - Limited by human eye resolution and alignment ability
 
-## Coordinate System
-A **coordinate system** is fully described by (1) the origin, (2) the interpretation of the axes, and (3) the units. In BIDS terms, a coordinate system comprises information about (1) the origin relative to which the coordinate is expressed, (2) the interpretation of the three axes, and (3) the units in which the numbers are expressed.
+2. **Level 2**: ~5% precision, such as Tape Measure
+   - Placement defined by measuring distances between landmarks
+   - Limited by tape measure resolution and alignment ability
 
-## Hierarchical Structure of Reference Frames
-Reference frames can have a hierarchical structure, where one reference frame is nested within another. For example, the position of the torso can be expressed within a room reference frame, the arm position relative to the torso, and the hand position relative to the arm. The reference frame at the top of this hierarchy is the **global reference frame**, associated with the space through which the entire body moves. This representation is useful in scenarios where the location of the person in space is relevant rather than their posture or limb motion.
+3. **Level 3**: ~1% precision, such as 3D Scanning
+   - Placement defined by 3D scanning body parts
+   - Limited by scanner resolution and alignment ability
 
-# Unified Placement Scheme
+### Standardized Annotation
 
-## Anatomical Coordinate System for Rigid Body Parts
-Axis definitions per body part are provided in the anatomical **[landmark table](./anatomical_table.qmd)**. The table includes the name of the body part, the axis, and the direction of the axis, defined using anatomical landmarks, with axis limits ranging from 0 to 100% of the distance between the landmarks.
+Sensor placement should be documented using a standardized format that includes:
 
-## Principles of Sensor Placement Annotation
-We propose a **unified placement scheme** for sensors based on anatomical landmarks and the axes defined in the anatomical landmark table. The scheme follows these principles:
+1. Body part name
+2. Axis name and direction
+3. Axis limits
+4. Sensor location (as ratio of axis limits)
+5. Placement precision level
 
-    1.	Sensor placement should be reproducible by a human with defined precision.
-    2.	Placement in each dimension should be related to the anatomical landmarks of the relevant body part.
-    3.	Landmarks define the origin, direction, and limits of the axes.
-    4.	Sensor locations should be reported as a ratio of the limits of each axis for each body part.
-    5.	Placement precision depends on the precision of landmarks, axes, and the measurement method.
+This framework does not prescribe specific annotation formats; different standards and specification can use the principles to develop their own. However, this framework is designed to be compatible with existing data sharing standards such as [Brain Imaging Data Structure (BIDS)](https://bids.neuroimaging.io/) and [Hierarchical Event Descriptors (HED)](https://www.hedtags.org/). Specifically, using this framework would provide precise details for the sensor placement as described in [Motion-BIDS](https://bids-specification.readthedocs.io/en/stable/modality-specific-files/motion.html).
 
-## Placement Precision
-The precision of sensor placement is related to the precision of landmark definitions, axis orthogonality, and measurement methods. We propose the following precision levels:
+An exemplar annotation following the general HED instructions can be represented as:
 
-1.	**Visual Inspection**: Placement defined by visual inspection of body parts and landmarks, limited by human eye resolution and alignment ability. Estimated precision: ~10% of the distance between landmarks.
-2.	**Tape Measure**: Placement defined by measuring distances between landmarks and placing the sensor at a specific ratio. Limited by tape measure resolution and alignment ability. Estimated precision: ~5% of the distance between landmarks.
-3. **3D Scanning**: Placement defined by 3D scanning body parts and placing the sensor at a specific ratio. Limited by 3D scanner resolution and alignment ability. Estimated precision: ~1% of the distance between landmarks.
+```
+(Body-part, (X-position/#, Y-position/#, Z-position/#), Precision)
+```
+(note that the exact HED tags are under development under [HED-SLAM](https://www.hedtags.org/display_hed_prerelease.html?schema=slam_prerelease))
 
-**Sensor placement precision** should always be reported in the dataset metadata.
+This standardization framework represents a significant step toward improving data quality, reproducibility, and interoperability in human movement analysis, from clinical biomechanics to continuous health monitoring.
 
-## Sensor Placement Annotation
-Sensor placement should be annotated using a standardized format, including:
+## How to Contribute
+**Contributions**: We welcome contributions to this framework from the research community. Please submit your suggestions and feedback via the [GitHub repository](https://github.com/human-sensor-placement/human-sensor-placement.github.io) Issues section. 
 
-    1.	Body part name
-    2.	Axis name
-    3.	Axis direction
-    4.	Axis limits
-    5.	Sensor location as a ratio of the axis limits
-    6.	Sensor placement precision
+There are specific areas where we seek contributions:
 
-### Hierchical Event Descriptors (HED) for Sensor Placement
-We *propose* using Hierarchical Event Descriptors (HED) to annotate sensor placement in a standardized format. A possible HED tag for sensor placement could be:
-
-    (Body-part, (X-position/#, Y-position/#, Z-position/#), Precision)
-
-Where:
-    
-- Body-part: The name of the body part where the sensor is placed.
-- X-position, Y-position, Z-position: The sensor's position along the X, Y, and Z axes, respectively, expressed as a ratio of the axis limits.
-- Precision: The precision level of sensor placement (e.g., Visual Inspection, Tape Measure, 3D Scanning).
-
-NOTE: This proopsal is still in discussion and we are open to feedback and suggestions. Importantly, we aim to establish a **HED partnered schemaw** to define (1) the anatomical landmarks, (2) axis limits, and (3) axis direction for each body part.
+- Standard vocabulary and communication formats through BIDS, HED, and other specifications
+- Validation studies for inter-operator reliability assessment
+- Mappings between this framework and existing standards (such as SENIAM)
+- Software tools for coordinate calculation and placement visualization