Last modified 2024-01-03

Support

Create, Edit, or Delete Metadata

Abbreviations Key
CSVcomma-separated values
HISEHuman Immune System Explorer
GUIDglobally unique identifier
SLIMSsimple laboratory information management system

At a Glance

If metadata fields are not provided in SLIMS, the Allen Institute's laboratory information management system, you can create your own samples, cohorts, or subjects. This document explains how to create, edit, or delete metadata, and includes example files for you to use.

Create Metadata

Most of the metadata in HISE is referenced from lab data in SLIMS. This tight coupling between SLIMS and HISE reduces human error to ensure accurate tracking of samples and lab resources. Sometimes, however, partners need to reference samples that exist outside of SLIMS. To track them, the direct cohort metadata ingest process lets you create your own cohorts, sample, subject, and specimen metadata values.

Before you can create your own metadata values, the HISE support team must first configure the project. It designates the file type for demographic ingest and defines the demographics scheme. You suppy a map to associate the fields in your CSV file with the metadata fields in HISE, as shown in the accompanying image. The map should also include the expected date format for fields that require one.

To format the CSV file correctly, it's helpful to understand how the metadata fields relate to one another at various levels and in various groups.

TABLE 1
LevelNameDescriptionExamples
1CohortServes as an umbrella for all other metadata fields. This is the highest-level grouping, beneath which all subjects and samples are grouped together by cohort. Each cohort has many related subjects and samples. The cohort (either a new one added by CSV or one that already exists in HISE) must be defined before you create subjects within the cohort. These two cohort columns are the only required fields.cohort

cohortDescription

2Subject

Subject fields represent the next level of granularity among the groupings. A single subject must be in a single cohort, but multiple samples or specimens might be associated with it.

HISE accommodates nonhuman metadata as well as human metadata. Subject fields for nonhuman species include genotype, mouseId, ageAtEnrollment, sacrificeDate, and strain.

subjectGuid

birthYear

ageAtEnrollment

ethnicity

race

sex

genotype

mouseId

sacrificeDate

strain

3Sample

The third-highest category includes sampleKitGuids and sample metadata. The relationship between sample and specimen is one to many. In other words, a single sample can be associatd with multiple specimens. However, a single sample is associated with only one subject.

Sample fields for nonhuman species include batchId, diseaseState, and notes.

batchId

sampleKitGuid

daysSinceFirstVisit

visitDetails

visitName

diseaseState

notes

4Specimen

The most granular metadata fields are those related to specimens, including specimenGuid. A single subject or sample can have multiple associated specimen fields. A specimen field is not an umbrella for any other field or group.

Specimen fields for nonhuman species include panelId, specimenType, specimenSource, and specimenTissueSubtype.

specimenGuid

panelId

specimenType

specimenSource

specimenTissueSubtype

totalViableCellCount

The CSV file shown in Table 2 (Demographics_example.csv) creates a new cohort with associated subject, sample, and specimen metadata. To add additional subjects, add additional rows

TABLE 2

cohort

cohortDescription

subjectGuid  

 sampleKitGuid 

 birthYear 

 daysSinceFirstVisit 

 ethnicity 

 race 

 sex

 specimenGuid 

 totalCellCount 

 visitDetails 

 visitName 

Cohort A

Good Cohort

Cohort A

subjectA

1999

other

other

male

subjectA

sampleAA

0

tired

firstVisit

sampleAAspecimenA9000

When you've supplied the necessary map to the support team, we create a watchfolder and share the link with you. You can then upload your CSV file and begin to create new metadata fields.

NOTE

The headers and date format in the file you upload must match the information you sent to the HISE support team. Otherwise, errors will occur, and you'll be unable to create new values.

Edit Metadata

To edit a subject, sample, or specimen metadata field you created, set up a CSV as in the attached example file (edit_demographics_example.csv). For sampleAA within subjectAA, the file changes values for fields like sex, birthYear, and daySinceFirstVisit

To make any edits, define the cohort, subjectGuid, or sampleKitGuid. Then assign the metadata fields you want to change.

Delete Metadata

HISE lets you soft-delete a cohort, subject, sample, or specimen. These deletions cascade to the fields below. For example, if you delete cohort, the umbrella that covers all other fields, the subjects, samples, and specimen files previously mapped to the deleted cohort are deleted as well. To soft-delete a field at any level, click the Support button in the upper-right corner of this page, or email immunology-support@allenimmunology.org with your request. 


Related Resources

Use Specified Metadata Models (Tutorial)


Tags