MiAIRR Data Elements

The AIRR Community has agreed to six high-level data sets that will guide the publication, curation and sharing of AIRR-Seq data and metadata: Study and subject, sample collection, sample processing and sequencing, raw sequences, processing of sequence data, and processed AIRR sequences.

Download as TSV.

Set Subset Designation Field Type Format Definition Example
1 study Study ID study_id string Free text Unique ID assigned by study registry PRJNA001
1 study Study title study_title string Free text Descriptive study title Effects of sun light exposure of the Treg repertoire
1 study Study type study_type string Ontology: { name: NCIT, top_node: {id: C63536, value: Study}, draft: True, url: https://www.ebi.ac.uk/ols/ontologies/ncit } Type of study design id: C15197, value: Case-Control Study
1 study Study inclusion/exclusion criteria inclusion_exclusion_criteria string Free text List of criteria for inclusion/exclusion for the study Include: Clinical P. falciparum infection; Exclude: Seropositive for HIV
1 study Grant funding agency grants string Free text Funding agencies and grant numbers NIH, award number R01GM987654
1 study Contact information (data collection) collected_by string Free text Full contact information of the data collector, i.e. the person who is legally responsible for data collection and release. This should include an e-mail address. Dr. P. Stibbons, p.stibbons@unseenu.edu
1 study Lab name lab_name string Free text Department of data collector Department for Planar Immunology
1 study Lab address lab_address string Free text Institution and institutional address of data collector School of Medicine, Unseen University, Ankh-Morpork, Disk World
1 study Contact information (data deposition) submitted_by string Free text Full contact information of the data depositor, i.e. the person submitting the data to a repository. This is supposed to be a short-lived and technical role until the submission is relased. Adrian Turnipseed, a.turnipseed@unseenu.edu
1 study Relevant publications pub_ids string Free text Publications describing the rationale and/or outcome of the study PMID:85642
1 study Keywords for study keywords_study array Free text Keywords describing properties of one or more data sets in a study [‘contains_ig’, ‘contains_paired_chain’]
1 subject Subject ID subject_id string Free text Subject ID assigned by submitter, unique within study SUB856413
1 subject Synthetic library synthetic boolean T | F TRUE for libraries in which the diversity has been synthetically generated (e.g. phage display)  
1 subject Organism organism string Ontology: { name: NCBITAXON, top_node: {id: 7776, value: Gnathostomata}, draft: False, url: https://www.ebi.ac.uk/ols/ontologies/ncbitaxon } Binomial designation of subject’s species id: 9096, value: Homo sapiens
1 subject Sex sex string Controlled vocabulary: [‘male’, ‘female’, ‘pooled’, ‘hermaphrodite’, ‘intersex’, ‘not collected’, ‘not applicable’] Biological sex of subject female
1 subject Age minimum age_min number Any positive number Specific age or lower boundary of age range. 60
1 subject Age maximum age_max number Any positive number Upper boundary of age range or equal to age_min for specific age. This field should only be null if age_min is null. 80
1 subject Age unit age_unit string Ontology: { name: Units of measurement ontology, top_node: {id: UO_0000003, value: time unit}, draft: True, url: https://www.ebi.ac.uk/ols/ontologies/UO } Unit of age range id: UO_0000036, value: year
1 subject Age event age_event string Free text Event in the study schedule to which Age refers. For NCBI BioSample this MUST be sampling. For other implementations submitters need to be aware that there is currently no mechanism to encode to potential delta between Age event and Sample collection time, hence the chosen events should be in temporal proximity. enrollment
1 subject Ancestry population ancestry_population string Free text Broad geographic origin of ancestry (continent) list of continents, mixed or unknown
1 subject Ethnicity ethnicity string Free text Ethnic group of subject (defined as cultural/language-based membership) English, Kurds, Manchu, Yakuts (and other fields from Wikipedia)
1 subject Race race string Free text Racial group of subject (as defined by NIH) White, American Indian or Alaska Native, Black, Asian, Native Hawaiian or Other Pacific Islander, Other
1 subject Strain name strain_name string Free text Non-human designation of the strain or breed of animal used C57BL/6J
1 subject Relation to other subjects linked_subjects string Free text Subject ID to which Relation type refers SUB1355648
1 subject Relation type link_type string Free text Relation between subject and linked_subjects, can be genetic or environmental (e.g.exposure) father, daughter, household
1 diagnosis and intervention Study group description study_group_description string Free text Designation of study arm to which the subject is assigned to control
1 diagnosis and intervention Diagnosis disease_diagnosis string Free text Diagnosis of subject Multiple myeloma
1 diagnosis and intervention Length of disease disease_length string Physical quantity Time duration between initial diagnosis and current intervention 23 months
1 diagnosis and intervention Disease stage disease_stage string Free text Stage of disease at current intervention Stage II
1 diagnosis and intervention Prior therapies for primary disease under study prior_therapies string Free text List of all relevant previous therapies applied to subject for treatment of Diagnosis melphalan/prednisone
1 diagnosis and intervention Immunogen/agent immunogen string Free text Antigen, vaccine or drug applied to subject at this intervention bortezomib
1 diagnosis and intervention Intervention definition intervention string Free text Description of intervention systemic chemotherapy, 6 cycles, 1.25 mg/m2
1 diagnosis and intervention Other relevant medical history medical_history string Free text Medical history of subject that is relevant to assess the course of disease and/or treatment MGUS, first diagnosed 5 years prior
2 sample Biological sample ID sample_id string Free text Sample ID assigned by submitter, unique within study SUP52415
2 sample Sample type sample_type string Free text The way the sample was obtained, e.g. fine-needle aspirate, organ harvest, peripheral venous puncture Biopsy
2 sample Tissue tissue string Free text The actual tissue sampled, e.g. lymph node, liver, peripheral blood Bone marrow
2 sample Anatomic site anatomic_site string Free text The anatomic location of the tissue, e.g. Inguinal, femur Iliac crest
2 sample Disease state of sample disease_state_sample string Free text Histopathologic evaluation of the sample Tumor infiltration
2 sample Sample collection time collection_time_point_relative string Physical quantity Time point at which sample was taken, relative to Collection time event 14 d
2 sample Collection time event collection_time_point_reference string Free text Event in the study schedule to which Sample collection time relates to Primary vaccination
2 sample Biomaterial provider biomaterial_provider string Free text Name and address of the entity providing the sample Tissues-R-Us, Tampa, FL, USA
3 process (cell) Tissue processing tissue_processing string Free text Enzymatic digestion and/or physical methods used to isolate cells from sample Collagenase A/Dnase I digested, followed by Percoll gradient
3 process (cell) Cell subset cell_subset string Ontology: { name: CL, top_node: {id: CL_0000542, value: lymphocyte}, draft: True, url: https://www.ebi.ac.uk/ols/ontologies/cl } Commonly-used designation of isolated cell population id: CL_0000972, value: class switched memory B cell
3 process (cell) Cell subset phenotype cell_phenotype string Free text List of cellular markers and their expression levels used to isolate the cell population CD19+ CD38+ CD27+ IgM- IgD-
3 process (cell) Single-cell sort single_cell boolean T | F TRUE if single cells were isolated into separate compartments  
3 process (cell) Number of cells in experiment cell_number integer Any positive integer Total number of cells that went into the experiment 1000000
3 process (cell) Number of cells per sequencing reaction cells_per_reaction integer Any positive integer Number of cells for each biological replicate 50000
3 process (cell) Cell storage cell_storage boolean T | F TRUE if cells were cryo-preserved between isolation and further processing True
3 process (cell) Cell quality cell_quality string Free text Relative amount of viable cells after preparation and (if applicable) thawing 90% viability as determined by 7-AAD
3 process (cell) Cell isolation / enrichment procedure cell_isolation string Free text Description of the procedure used for marker-based isolation or enrich cells Cells were stained with fluorochrome labeled antibodies and then sorted on a FlowMerlin (CE) cytometer
3 process (cell) Processing protocol cell_processing_protocol string Free text Description of the methods applied to the sample including cell preparation/ isolation/enrichment and nucleic acid extraction. This should closely mirror the Materials and methods section in the manuscript Stimulated wih anti-CD3/anti-CD28
3 process (nucleic acid [pcr]) Target locus for PCR pcr_target_locus string Controlled vocabulary: [‘IGH’, ‘IGI’, ‘IGK’, ‘IGL’, ‘TRA’, ‘TRB’, ‘TRD’, ‘TRG’] Designation of the target locus. Note that this field uses a controlled vocubulary that is meant to provide a generic classification of the locus, not necessarily the correct designation according to a specific nomenclature. IGK
3 process (nucleic acid [pcr]) Forward PCR primer target location forward_pcr_primer_target_location string Free text Position of the most distal nucleotide templated by the forward primer or primer mix IGHV, +23
3 process (nucleic acid [pcr]) Reverse PCR primer target location reverse_pcr_primer_target_location string Free text Position of the most proximal nucleotide templated by the reverse primer or primer mix IGHG, +57
3 process (nucleic acid) Target substrate template_class string Controlled vocabulary: [‘DNA’, ‘RNA’] The class of nucleic acid that was used as primary starting material for the following procedures RNA
3 process (nucleic acid) Target substrate quality template_quality string Free text Description and results of the quality control performed on the template material RIN 9.2
3 process (nucleic acid) Template amount template_amount string Physical quantity Amount of template that went into the process 1000 ng
3 process (nucleic acid) Library generation method library_generation_method string Controlled vocabulary: [‘PCR’, ‘RT(RHP)+PCR’, ‘RT(oligo-dT)+PCR’, ‘RT(oligo-dT)+TS+PCR’, ‘RT(oligo-dT)+TS(UMI)+PCR’, ‘RT(specific)+PCR’, ‘RT(specific)+TS+PCR’, ‘RT(specific)+TS(UMI)+PCR’, ‘RT(specific+UMI)+PCR’, ‘RT(specific+UMI)+TS+PCR’, ‘RT(specific)+TS’, ‘other’] Generic type of library generation RT(oligo-dT)+TS(UMI)+PCR
3 process (nucleic acid) Library generation protocol library_generation_protocol string Free text Description of processes applied to substrate to obtain a library that is ready for sequencing cDNA was generated using
3 process (nucleic acid) Protocol IDs library_generation_kit_version string Free text When using a library generation protocol from a commercial provider, provide the protocol version number v2.1 (2016-09-15)
3 process (nucleic acid) Complete sequences complete_sequences string Controlled vocabulary: [‘partial’, ‘complete’, ‘complete+untemplated’] To be considered complete, the procedure used for library construction MUST generate sequences that 1) include the first V gene codon that encodes the mature polypeptide chain (i.e. after the leader sequence) and 2) include the last complete codon of the J gene (i.e. 1 bp 5’ of the J->C splice site) and 3) provide sequence information for all positions between 1) and 2). To be considered complete & untemplated, the sections of the sequences defined in points 1) to 3) of the previous sentence MUST be untemplated, i.e. MUST NOT overlap with the primers used in library preparation. partial
3 process (nucleic acid) Physical linkage of different loci physical_linkage string Controlled vocabulary: [‘none’, ‘hetero_head-head’] Describes the mode of linkage if a method was used which physically links nucleic acids derived from distinct loci in a single-cell context. hetero_head-head
3 process (sequencing) Batch number sequencing_run_id string Free text ID of sequencing run assigned by the sequencing facility 160101_M01234_0201_000000000-D2T7V
3 process (sequencing) Total reads passing QC filter total_reads_passing_qc_filter integer Any positive integer Number of usable reads for analysis 10365118
3 process (sequencing) Sequencing platform sequencing_platform string Free text Designation of sequencing instrument used Alumina LoSeq 1000
3 process (sequencing) Read lengths read_length string Free text Read length in bases for each direction [300,300]
3 process (sequencing) Sequencing facility sequencing_facility string Free text Name and address of sequencing facility Seqs-R-Us, Vancouver, BC, Canada
3 process (sequencing) Date of sequencing run sequencing_run_date string Free text Date of sequencing run 2016-12-16
3 process (sequencing) Sequencing kit sequencing_kit string Free text Name, manufacturer, order and lot numbers of sequencing kit FullSeq 600, Alumina, #M123456C0, 789G1HK
4 data (raw reads) Raw sequencing data file type file_type string Controlled vocabulary: [‘fasta’, ‘fastq’] File format for the raw reads or sequences  
4 data (raw reads) Raw sequencing data file name filename string Free text File name for the raw reads or sequences. The first file in paired-read sequencing MS10R-NMonson-C7JR9_S1_R1_001.fastq
4 data (raw reads) Read direction read_direction string Controlled vocabulary: [‘forward’, ‘reverse’, ‘mixed’] Read direction for the raw reads or sequences. The first file in paired-read sequencing forward
4 data (raw reads) Raw sequencing data file name paired_filename string Free text File name for the second file in paired-read sequencing MS10R-NMonson-C7JR9_S1_R2_001.fastq
4 data (raw reads) Read direction paired_read_direction string Controlled vocabulary: [‘forward’, ‘reverse’, ‘mixed’] Read direction for the second file in paired-read sequencing reverse
5 process (computational) Software tools and version numbers software_versions string Free text Version number and / or date, include company pipelines IgBLAST 1.6
5 process (computational) Paired read assembly paired_reads_assembly string Free text How paired end reads were assembled into a single receptor sequence PandaSeq (minimal overlap 50, threshold 0.8)
5 process (computational) Quality thresholds quality_thresholds string Free text How sequences were removed from (4) based on base quality scores Average Phred score >=20
5 process (computational) Primer match cutoffs primer_match_cutoffs string Free text How primers were identified in the sequences, were they removed/masked/etc? Hamming distance <= 2
5 process (computational) Collapsing method collapsing_method string Free text The method used for combining multiple sequences from (4) into a single sequence in (5) MUSCLE 3.8.31
5 process (computational) Data processing protocols data_processing_protocols string Free text General description of how QC is performed Data was processed using […]
5 data (processed sequence) V(D)J germline reference database germline_database string Free text Source of germline V(D)J genes with version number or date accessed. ENSEMBL, Homo sapiens build 90, 2017-10-01
6 data (processed sequence) V gene with allele v_call string Free text V gene with allele. If referring to a known reference sequence in a database the relevant gene/allele nomenclature should be followed (e.g., IGHV4-59*01 if using IMGT/GENE-DB). IGHV4-59*01
6 data (processed sequence) D gene with allele d_call string Free text First or only D gene with allele. If referring to a known reference sequence in a database the relevant gene/allele nomenclature should be followed (e.g., IGHD3-10*01 if using IMGT/GENE-DB). IGHD3-10*01
6 data (processed sequence) J gene with allele j_call string Free text J gene with allele. If referring to a known reference sequence in a database the relevant gene/allele nomenclature should be followed (e.g., IGHJ4*02 if using IMGT/GENE-DB). IGHJ4*02
6 data (processed sequence) C region c_call string Free text Constant region gene with allele. If referring to a known reference sequence in a database the relevant gene/allele nomenclature should be followed (e.g., IGHG1*01 if using IMGT/GENE-DB). IGHG1*01
6 data (processed sequence) IMGT-JUNCTION nucleotide sequence junction string Free text Junction region nucleotide sequence, where the junction is defined as the CDR3 plus the two flanking conserved codons. TGTGCAAGAGCGGGAGTTTACGACGGATATACTATGGACTACTGG
6 data (processed sequence) IMGT-JUNCTION amino acid sequence junction_aa string Free text Junction region amino acid sequence. CARAGVYDGYTMDYW
6 data (processed sequence) Read count duplicate_count integer Any positive integer Copy number or number of duplicate observations for the query sequence. For example, the number of UMIs sharing an identical sequence or the number of identical observations of this sequence absent UMIs. 123
6 data (processed sequence) Paired-chain index pair_id string Free text Valid sequence_id that was determined by experimental or computational means to be associated with the current Rearrangement on the cellular level. ABC314159
6 data (processed sequence) Cell index cell_id string Free text Identifier defining the cell of origin for the query sequence. W06_046_091