Sequence Assays

bulkATACseq

Related files:

This schema is for Assay for Transposase-Accessible Chromatin by sequencing (ATACseq)of bulk sample.

Metadata schema

Version 1 (use this one)
Shared by all types

version
description
donor_id
tissue_id
execution_datetime
protocols_io_doi
operator
operator_email
pi
pi_email
assay_category
assay_type
analyte_class
is_targeted
acquisition_instrument_vendor
acquisition_instrument_model

Unique to this type

bulk_transposition_input_number_nuclei
bulk_atac_cell_isolation_protocols_io_doi
is_technical_replicate
library_adapter_sequence
library_average_fragment_size
library_concentration_value
library_concentration_unit
library_construction_protocols_io_doi
library_creation_date
library_final_yield_value
library_final_yield_unit
library_id
library_layout
library_pcr_cycles
library_preparation_kit
sample_quality_metric
sequencing_phix_percent
sequencing_read_format
sequencing_read_percent_q30
sequencing_reagent_kit
transposition_kit_number
transposition_method
transposition_transposase_source
contributors_path
data_path

Shared by all types

version

Version of the schema to use when validating this metadata.

constraint value
enum 1
required True

description

Free-text description of this assay.

constraint value
required True

donor_id

HuBMAP Display ID of the donor of the assayed tissue. Example: ABC123.

constraint value
pattern (regular expression) [A-Z]+[0-9]+
required True

tissue_id

HuBMAP Display ID of the assayed tissue. Example: ABC123-BL-1-2-3_456.

constraint value
pattern (regular expression) (([A-Z]+[0-9]+)-[A-Z]{2}\d*(-\d+)+(_\d+)?)(,([A-Z]+[0-9]+)-[A-Z]{2}\d*(-\d+)+(_\d+)?)*
required True

execution_datetime

Start date and time of assay, typically a date-time stamped folder generated by the acquisition instrument. YYYY-MM-DD hh:mm, where YYYY is the year, MM is the month with leading 0s, and DD is the day with leading 0s, hh is the hour with leading zeros, mm are the minutes with leading zeros.

constraint value
type datetime
format %Y-%m-%d %H:%M
required True

protocols_io_doi

DOI for protocols.io referring to the protocol for this assay.

constraint value
required True
pattern (regular expression) 10\.17504/.*
url prefix: https://dx.doi.org/

operator

Name of the person responsible for executing the assay.

constraint value
required True

operator_email

Email address for the operator.

constraint value
format email
required True

pi

Name of the principal investigator responsible for the data.

constraint value
required True

pi_email

Email address for the principal investigator.

constraint value
format email
required True

assay_category

Each assay is placed into one of the following 4 general categories: generation of images of microscopic entities, identification & quantitation of molecules by mass spectrometry, imaging mass spectrometry, and determination of nucleotide sequence.

constraint value
enum sequence
required True

assay_type

The specific type of assay being executed.

constraint value
enum bulkATACseq
required True

analyte_class

Analytes are the target molecules being measured with the assay.

constraint value
enum DNA
required True

is_targeted

Specifies whether or not a specific molecule(s) is/are targeted for detection/measurement by the assay.

constraint value
type boolean
required True

acquisition_instrument_vendor

An acquisition instrument is the device that contains the signal detection hardware and signal processing software. Assays generate signals such as light of various intensities or color or signals representing the molecular mass.

constraint value
required True

acquisition_instrument_model

Manufacturers of an acquisition instrument may offer various versions (models) of that instrument with different features or sensitivities. Differences in features or sensitivities may be relevant to processing or interpretation of the data.

constraint value
required True

Unique to this type

bulk_transposition_input_number_nuclei

A number (no comma separators)

constraint value
required True

bulk_atac_cell_isolation_protocols_io_doi

Link to a protocols document answering the question: How was tissue stored and processed for cell/nuclei isolation.

constraint value
required True
pattern (regular expression) 10\.17504/.*
url prefix: https://dx.doi.org/

is_technical_replicate

Is this a sequencing replicate?

constraint value
type boolean
required True

library_adapter_sequence

Adapter sequence to be used for adapter trimming.

constraint value
required True

library_average_fragment_size

Average size in basepairs (bp) of sequencing library fragments estimated via gel electrophoresis or bioanalyzer/tapestation.

constraint value
type integer
required True

library_concentration_value

The concentration value of the pooled library samples submitted for sequencing.

constraint value
type number
required True

library_concentration_unit

Unit of library_concentration_value. Leave blank if not applicable.

constraint value
enum nM
required False
required if library_concentration_value present

library_construction_protocols_io_doi

A link to the protocol document containing the library construction method (including version) that was used, e.g. “Smart-Seq2”, “Drop-Seq”, “10X v3”.

constraint value
required True
pattern (regular expression) 10\.17504/.*
url prefix: https://dx.doi.org/

library_creation_date

date and time of library creation. YYYY-MM-DD, where YYYY is the year, MM is the month with leading 0s, and DD is the day with leading 0s. Leave blank if not applicable.

constraint value
type datetime
format %Y-%m-%d
required False

library_final_yield_value

Total number of ng of library after final pcr amplification step. This is the concentration (ng/ul) * volume (ul)

constraint value
type number
required True

library_final_yield_unit

Units of final library yield. Leave blank if not applicable.

constraint value
enum ng
required False
required if library_final_yield_value present

library_id

A library ID, unique within a TMC, which allows corresponding RNA and chromatin accessibility datasets to be linked.

constraint value
required True

library_layout

State whether the library was generated for single-end or paired end sequencing.

constraint value
enum single-end or paired-end
required True

library_pcr_cycles

Number of PCR cycles performed in order to add adapters and amplify the library. Usually, this includes 5 pre-amplificationn cycles followed by 0-5 additional cycles determined by qPCR.

constraint value
type integer
required True

library_preparation_kit

Reagent kit used for library preparation.

constraint value
required True

sample_quality_metric

This is a quality metric by visual inspection. This should answer the question: Are the nuclei intact and are the nuclei free of significant amounts of debris? This can be captured at a high level, “OK” or “not OK”.

constraint value
required True

sequencing_phix_percent

Percent PhiX loaded to the run.

constraint value
type number
required True
minimum 0
maximum 100

sequencing_read_format

Slash-delimited list of the number of sequencing cycles for, for example, Read1, i7 index, i5 index, and Read2. Example: 12/34/56.

constraint value
pattern (regular expression) \d+(/\d+)+
required True

sequencing_read_percent_q30

Q30 is the weighted average of all the reads (e.g. # bases UMI * q30 UMI + # bases R2 * q30 R2 + …)

constraint value
type number
required True
minimum 0
maximum 100

sequencing_reagent_kit

Reagent kit used for sequencing.

constraint value
required True

transposition_kit_number

If Tn5 came from a kit, provide the catalog number. Leave blank if not applicable.

constraint value
required False

transposition_method

Modality of capturing accessible chromatin molecules. The kit used, for example.

constraint value
required True

transposition_transposase_source

The source of the Tn5 transposase and transposon used for capturing accessible chromatin.

constraint value
required True

contributors_path

Relative path to file with ORCID IDs for contributors for this dataset.

constraint value
required True

data_path

Relative path to file or directory with instrument data. Downstream processing will depend on filename extension conventions.

constraint value
required True
Version 0

Shared by all types

donor_id

HuBMAP Display ID of the donor of the assayed tissue. Example: ABC123.

constraint value
pattern (regular expression) [A-Z]+[0-9]+
required True

tissue_id

HuBMAP Display ID of the assayed tissue. Example: ABC123-BL-1-2-3_456.

constraint value
pattern (regular expression) ([A-Z]+[0-9]+)-[A-Z]{2}\d*(-\d+)+(_\d+)?
required True

execution_datetime

Start date and time of assay, typically a date-time stamped folder generated by the acquisition instrument. YYYY-MM-DD hh:mm, where YYYY is the year, MM is the month with leading 0s, and DD is the day with leading 0s, hh is the hour with leading zeros, mm are the minutes with leading zeros.

constraint value
type datetime
format %Y-%m-%d %H:%M
required True

protocols_io_doi

DOI for protocols.io referring to the protocol for this assay.

constraint value
required True
pattern (regular expression) 10\.17504/.*
url prefix: https://dx.doi.org/

operator

Name of the person responsible for executing the assay.

constraint value
required True

operator_email

Email address for the operator.

constraint value
format email
required True

pi

Name of the principal investigator responsible for the data.

constraint value
required True

pi_email

Email address for the principal investigator.

constraint value
format email
required True

assay_category

Each assay is placed into one of the following 4 general categories: generation of images of microscopic entities, identification & quantitation of molecules by mass spectrometry, imaging mass spectrometry, and determination of nucleotide sequence.

constraint value
enum sequence
required True

assay_type

The specific type of assay being executed.

constraint value
enum bulkATACseq
required True

analyte_class

Analytes are the target molecules being measured with the assay.

constraint value
enum DNA
required True

is_targeted

Specifies whether or not a specific molecule(s) is/are targeted for detection/measurement by the assay.

constraint value
type boolean
required True

acquisition_instrument_vendor

An acquisition instrument is the device that contains the signal detection hardware and signal processing software. Assays generate signals such as light of various intensities or color or signals representing the molecular mass.

constraint value
required True

acquisition_instrument_model

Manufacturers of an acquisition instrument may offer various versions (models) of that instrument with different features or sensitivities. Differences in features or sensitivities may be relevant to processing or interpretation of the data.

constraint value
required True

Unique to this type

bulk_transposition_input_number_nuclei

A number (no comma separators)

constraint value
required True

bulk_atac_cell_isolation_protocols_io_doi

Link to a protocols document answering the question: How was tissue stored and processed for cell/nuclei isolation.

constraint value
required True
pattern (regular expression) 10\.17504/.*
url prefix: https://dx.doi.org/

is_technical_replicate

Is this a sequencing replicate?

constraint value
type boolean
required True

library_adapter_sequence

Adapter sequence to be used for adapter trimming.

constraint value
required True

library_average_fragment_size

Average size in basepairs (bp) of sequencing library fragments estimated via gel electrophoresis or bioanalyzer/tapestation.

constraint value
type integer
required True

library_concentration_value

The concentration value of the pooled library samples submitted for sequencing.

constraint value
type number
required True

library_concentration_unit

Unit of library_concentration_value. Leave blank if not applicable.

constraint value
enum nM
required False
required if library_concentration_value present

library_construction_protocols_io_doi

A link to the protocol document containing the library construction method (including version) that was used, e.g. “Smart-Seq2”, “Drop-Seq”, “10X v3”.

constraint value
required True
pattern (regular expression) 10\.17504/.*
url prefix: https://dx.doi.org/

library_creation_date

date and time of library creation. YYYY-MM-DD, where YYYY is the year, MM is the month with leading 0s, and DD is the day with leading 0s. Leave blank if not applicable.

constraint value
type datetime
format %Y-%m-%d
required False

library_final_yield_value

Total number of ng of library after final pcr amplification step. This is the concentration (ng/ul) * volume (ul)

constraint value
type number
required True

library_final_yield_unit

Units of final library yield. Leave blank if not applicable.

constraint value
enum ng
required False
required if library_final_yield_value present

library_id

A library ID, unique within a TMC, which allows corresponding RNA and chromatin accessibility datasets to be linked.

constraint value
required True

library_layout

State whether the library was generated for single-end or paired end sequencing.

constraint value
enum single-end or paired-end
required True

library_pcr_cycles

Number of PCR cycles performed in order to add adapters and amplify the library. Usually, this includes 5 pre-amplificationn cycles followed by 0-5 additional cycles determined by qPCR.

constraint value
type integer
required True

library_preparation_kit

Reagent kit used for library preparation.

constraint value
required True

sample_quality_metric

This is a quality metric by visual inspection. This should answer the question: Are the nuclei intact and are the nuclei free of significant amounts of debris? This can be captured at a high level, “OK” or “not OK”.

constraint value
required True

sequencing_phix_percent

Percent PhiX loaded to the run.

constraint value
type number
required True
minimum 0
maximum 100

sequencing_read_format

Slash-delimited list of the number of sequencing cycles for, for example, Read1, i7 index, i5 index, and Read2. Example: 12/34/56.

constraint value
pattern (regular expression) \d+(/\d+)+
required True

sequencing_read_percent_q30

Q30 is the weighted average of all the reads (e.g. # bases UMI * q30 UMI + # bases R2 * q30 R2 + …)

constraint value
type number
required True
minimum 0
maximum 100

sequencing_reagent_kit

Reagent kit used for sequencing.

constraint value
required True

transposition_kit_number

If Tn5 came from a kit, provide the catalog number. Leave blank if not applicable.

constraint value
required False

transposition_method

Modality of capturing accessible chromatin molecules. The kit used, for example.

constraint value
required True

transposition_transposase_source

The source of the Tn5 transposase and transposon used for capturing accessible chromatin.

constraint value
required True

contributors_path

Relative path to file with ORCID IDs for contributors for this dataset.

constraint value
required True

data_path

Relative path to file or directory with instrument data. Downstream processing will depend on filename extension conventions.

constraint value
required True


Directory schemas

Version 0.0 (use this one)
pattern required? description
.*\.fastq\.gz TODO: https://github.com/hubmapconsortium/ingest-validation-tools/issues/445
extras\/.*   Folder for general lab-specific files related to the dataset. [Exists in all assays]