Additional information can be found on the Discussion page.


Open Knee(s) project will generate a plethora of heterogeneous data sets, e.g. DICOM images, joint/tissue mechanical testing data, etc. It is unnecessary and sometimes clumsy to put the data into source code repositories. The workflow of the "Downloads" section at the project site also seems cumbersome for intermediate storage of data, which may not be release ready. This specification is targeted to find a solution for online curation and storage of data (in-house or at Open Knee(s) project site) that will accommodate the workflow of data collection, analysis, and public release. A separate project site at is available to expand management of data and relevant information for biomechanics studies beyond the realm of Open Knee(s), see

Target Outcome

Curation and storage of specimen/sample associated data for discoverability, retrieval, and dissemination



Previous Protocols

Any experimentation protocol, see:


Specimen/Sample Labeling


Whole knee specimen labels include the Open Knee(s) abbreviation in lower case, oks, immediately followed by three numerals to indicate specimen number, e.g. 001. An example for knee specimen labeling is in following:

Open Knee(s) Specimen 1


Tissue testing plans of Open Knee(s) will require a large set of tissue samples acquired from a single knee specimen; see details in Specifications/SpecimenPreparation and Specifications/ExperimentationTissueMechanics. For example, confined and unconfined compression testing of cartilage will require a total of 10 samples from medial and lateral sides of femur and tibia, and from patella. Compression and tension testing of menisci will require a total of 4 samples from medial and lateral sides. Uniaxial tension testing of ligaments and tendons will require a total of 6 samples from their midsubstance (cruciate, collateral, and patellar ligaments, quadriceps tendon). For a single knee, a total of 20 tissue samples may need to acquired, indicating a need for organization of samples and accompanying data.

Labels for tissue samples include knee specimen label, e.g. oks002, followed by three letter tissue type in upper case, e.g. TBC, four letter tissue location in upper case (from gross to granular location, lower case if at microscale), and two numerals to indicate sample number. When needed, the character X is used as a filler. A few examples for tissue samples are in following:

sample 2 from patellar cartilage of Open Knee(s) Specimen 1, acquired from the medial side at the center.
sample 1 from medial meniscus of Open Knee(s) Specimen 2, acquired from middle layer of the tissue at the anterior side.

Tissue Types

Tissue Locations

The tissue location is labeled starting from its gross location and ending with its granular position.

Examples (only tissue type and tissue location are shown):

femoral cartilage sample acquired medially and anteriorly
tibial cartilage sample acquired laterally and anteriorly from the superficial zone
femoral cartilage sample acquired from the trochlear groove
sample acquired from lateral meniscus centrally and from mid-substance
medial collateral ligament sample acquired from inferior region


Model Labeling

Model geometry is derived from MR image data. Therefore, model component labeling should include the specific MR image set/protocol from which the model geometry is derived. The proposed model labeling convention extends and utilizes the Specimen/Sample Labeling convention to specify the model component (but only uses one character to specify model component/tissue sub-location instead of four, e.g. -M, medial; -L, lateral; -S, superior; etc.).



Registration Markers

Tissue Type/Location


oks001 specimen, general purpose MRI, posterior femur registration marker sphere, version 1, NifTI image
oks001, cartilage MRI, lateral meniscus, NifTI image
oks001, sagittal ligament/tendon (connective tissue) MRI, superior patella registration marker sphere, version 3, NifTI image

Organization of Authors

When segmenting, record the three letter initials of the segmentor (use an X if no middle name) after the tissue description and before the version number, separated by underscores.


oks001 specimen, general purpose MRI, posterior femur registration marker sphere, segmentor is John Paul Smith (JPS), version 1, NifTI image
oks001, sagittal ligament/tendon (connective tissue) MRI, superior patella registration marker sphere, segmentor is Fred Johnson (no middle name, FXJ), version 3, NifTI image





Data Labeling

During data collection, the data sets, testing conditions, trials can be labeled through various conventions of experimentation systems and at the convenience of the personnel acquiring the data. Nonetheless, for data curation, organization, and dissemination data labels should be associated with

This information can be provided in

Data Curation

For a given whole knee specimen, Open Knee(s) data will be acquired asynchronously through a variety of modalities including anatomical imaging, mechanical testing of joints, and characterization of tissue specimens, see

The in-house data management system, based on Midas Platform, will be used as a staging server for data curation and documentation. Once data is collected, the person leading the acquisition activity should ensure association of data labels, specimen/sample labels and provide descriptors of experiment conditions (see section above). In following, data should be uploaded to the in-house data management system for collation of different data sets and for organization. An example hierarchical structure for data organization is in following:

├── oks001
│   ├── joint
│   │   ├── patellofemoral
│   │   └── tibiofemoral
│   │       ├── photos
│   │       ├── readme.txt
│   │       └── trial001
│   ├── mri
│   │   ├── cartilage
│   │   ├── connective
│   │   │   ├── axial
│   │   │   ├── coronal
│   │   │   └── sagittal
│   │   └── general
│   ├── photos
│   ├── specs
│   └── tissue
│       ├── bone
│       ├── cartilage
│       ├── ligament
│       │   └── ACL
│       │       ├── photos
│       │       └── readme.txt
│       ├── meniscus
│       └── tendon
├── oks002
├── oks003
├── ...

Data Dissemination

Once data for the whole knee is curated, organized and documented; the project website will be used for dissemination, through the "Downloads" section of

Specifications/DataManagement (last edited 2019-04-05 18:29:59 by owings)