DESI Metadata Attributes

Fields that are collected for DESI data, available at dataset.metadata.<attribute>

* indicates a required field

Attribute	Description	Allowable Values
parent_sample_id *	Unique HuBMAP or SenNet identifier of the sample (i.e., block, section or suspension) used to perform this assay. For example, for a RNAseq assay, the parent would be the suspension, whereas, for one of the imaging assays, the parent would be the tissue section. If an assay comes from multiple parent samples then this should be a comma separated list. Example: HBM386.ZGKG.235, HBM672.MKPK.442 or SNT232.UBHJ.322, SNT329.ALSK.102
lab_id	A locally assigned identifier provided by the data provider for the dataset. It is used to reference an external metadata record that may be maintained independently, enabling traceability and supporting provenance tracking. Example: Visium_9OLC_A4_S1
preparation_protocol_doi *	DOI for the protocols.io page that describes the assay or sample procurment and preparation. For example for an imaging assay, the protocol might include staining of a section through the creation of an OME-TIFF file. In this case the protocol would include any image processing steps required to create the OME-TIFF file. Example: https://dx.doi.org/10.17504/protocols.io.eq2lyno9qvx9/v1
dataset_type *	The specific type of dataset being produced.	`10X Multiome` `2D Imaging Mass Cytometry` `ATACseq` `Auto-fluorescence` `Cell DIVE` `CODEX` `Confocal` `CosMx` `CyCIF` `DBiT` `DESI` `Enhanced Stimulated Raman Spectroscopy (SRS)` `GeoMx (nCounter)` `GeoMx (NGS)` `HiFi-Slide` `Histology` `LC-MS` `Light Sheet` `MALDI` `MERFISH` `MIBI` `Molecular Cartography` `MUSIC` `nanoSPLITS` `PhenoCycler` `Resolve` `RNAseq` `RNAseq (with probes)` `Second Harmonic Generation (SHG)` `SIMS` `SNARE-seq2` `Stereo-seq` `Thick section Multiphoton MxIF` `Visium (no probes)` `Visium (with probes)` `Xenium`
analyte_class *	Analytes are the target molecules being measured with the assay.	`Chromatin` `DNA` `DNA + RNA` `Endogenous fluorophores` `Fluorochrome` `Lipid` `Metabolite` `Nucleic acid and protein` `Peptide` `Polysaccharide` `Protein` `RNA`
is_targeted *	Specifies whether or not a specific molecule(s) is/are targeted for detection/measurement by the assay (“Yes” or “No”). The CODEX analyte is protein.
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.	`Akoya Biosciences` `Andor` `BGI Genomics` `Bruker` `Cytiva` `Evident Scientific (Olympus)` `GE Healthcare` `Hamamatsu` `Huron Digital Pathology` `Illumina` `In-House` `Ionpath` `Keyence` `Leica Biosystems` `Leica Microsystems` `Motic` `NanoString` `Resolve Biosciences` `Sciex` `Standard BioTools (Fluidigm)` `Thermo Fisher Scientific` `Zeiss Microscopy`
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.	`Aperio AT2` `Aperio CS2` `Axio Observer 3` `Axio Observer 5` `Axio Observer 7` `Axio Scan.Z1` `BZ-X710` `BZ-X800` `BZ-X810` `CosMx Spatial Molecular Imager` `Custom: Multiphoton` `Digital Spatial Profiler` `DM6 B` `DNBSEQ-T7` `EVOS M7000` `HiSeq 2500` `HiSeq 4000` `Hyperion Imaging System` `IN Cell Analyzer 2200` `Lightsheet 7` `MALDI timsTOF Flex Prototype` `MIBIscope` `MoticEasyScan One` `NanoZoomer 2.0-HT` `NanoZoomer S210` `NanoZoomer S360` `NanoZoomer S60` `NanoZoomer-SQ` `NextSeq 2000` `NextSeq 500` `NextSeq 550` `NovaSeq 6000` `NovaSeq X` `NovaSeq X Plus` `Orbitrap Eclipse Tribrid` `Orbitrap Fusion Lumos Tribrid` `Phenocycler-Fusion 1.0` `Phenocycler-Fusion 2.0` `PhenoImager Fusion` `Q Exactive` `Q Exactive HF` `Q Exactive UHMR` `QTRAP 5500` `Resolve Biosciences Molecular Cartography` `SCN400` `STELLARIS 5` `TissueScope LE Slide Scanner` `Unknown` `VS200 Slide Scanner` `Xenium Analyzer` `Zyla 4.2 sCMOS`
source_storage_duration_value *	How long was the source material stored, prior to this sample being processed? For assays applied to tissue sections, this would be how long the tissue section (e.g., slide) was stored, prior to the assay beginning (e.g., imaging). For assays applied to suspensions such as sequencing, this would be how long the suspension was stored before library construction began.
source_storage_duration_unit *	The time duration unit of measurement	`hour` `month` `day` `minute` `year`
time_since_acquisition_instrument_calibration_value	The amount of time since the acqusition instrument was last serviced by the vendor. This provides a metric for assessing drift in data capture.
time_since_acquisition_instrument_calibration_unit	The time unit of measurement	`Column-by-column` `Not applicable` `Row-by-row` `Snake-by-columns` `Snake-by-rows`
contributors_path *	The path to the file with the ORCID IDs for all contributors of this dataset (e.g., “./extras/contributors.tsv” or “./contributors.tsv”). This is an internal metadata field that is just used for ingest.
data_path *	The top level directory containing the raw and/or processed data. For a single dataset upload this might be “.” where as for a data upload containing multiple datasets, this would be the directory name for the respective dataset. For instance, if the data is within a directory called “TEST001-RK” use syntax “./TEST001-RK” for this field. If there are multiple directory levels, use the format “./TEST001-RK/Run1/Pass2” in which “Pass2” is the subdirectory where the single dataset’s data is stored. This is an internal metadata field that is just used for ingest.
ms_ionization_technique *	The ionization approach (i.e., sample probing method) for performing imaging mass spectrometry.	`DESI` `ESI` `HESI` `LA` `LDI` `MALDI` `MALDI-2` `nanoDESI` `SIMS-C60` `SIMS-H20`
ms_scan_mode *	MS (mass spectrometry) scan mode refers to the number of steps in the separation of fragments.	`MS1` `MS2` `MS3`
mass_analysis_polarity *	The polarity of the mass analysis (positive or negative ion modes).	`Negative and positive ion mode` `Negative ion mode` `Positive ion mode`
mass_to_charge_range_low_value	The low value of the scanned mass-to-charge range, for MS1. (unitless)
mass_to_charge_range_high_value	The high value of the scanned mass-to-charge range, for MS1. (unitless)
mass_resolving_power *	The mass resolving power m/∆m, where ∆m is defined as the full width at half-maximum (FWHM) for a given peak with a specified mass-to-charge (m/z). (unitless)
mass_to_charge_resolving_power	The peak (m/z) used to calculate the resolving power.
ion_mobility	Specifies which technology was used for ion mobility spectrometry. Technologies for measuring ion mobility: Traveling Wave Ion Mobility Spectrometry (TWIMS), Trapped Ion Mobility Spectrometry (TIMS), High Field Asymmetric waveform ion Mobility Spectrometry (FAIMS), Drift Tube Ion Mobility Spectrometry (DTIMS), Structures for Lossless Ion Manipulations (SLIM), and cyclic Ion Mobility Spectrometry (cIMS).	`TIMS` `SLIM` `FAIMS` `DTIMS` `cIMS` `TWIMS`
matrix_deposition_method	Common methods of depositing matrix for assisting in desorption and ionization in imaging mass spectrometry include robotic spotting, electrospray deposition, and sublimation.	`Electrospray deposition` `Not applicable` `Robotic spotting` `Robotic spraying` `Sublimation`
preparation_instrument_vendor	The manufacturer of the instrument used to prepare (staining/processing) the sample for the assay. If an automatic slide staining method was indicated this field should list the manufacturer of the instrument.	`10x Genomics` `Hamamatsu` `HTX Technologies` `In-House` `Leica Biosystems` `Not applicable` `Roche Diagnostics` `SunChrom` `Thermo Fisher Scientific`
preparation_instrument_model	Manufacturers of a staining system instrument may offer various versions (models) of that instrument with different features. Differences in features or sensitivities may be relevant to processing or interpretation of the data.	`AutoStainer XL` `Chromium Connect` `Chromium Controller` `Chromium iX` `Chromium X` `Discovery Ultra` `EVOS M7000` `M3+ Sprayer` `M5 Sprayer` `NanoZoomer S210` `NanoZoomer S360` `NanoZoomer S60` `Not applicable` `ST5020 Multistainer` `Sublimator` `SunCollect Sprayer` `TM-Sprayer` `Visium CytAssist`
preparation_matrix	The matrix is a compound of crystallized molecules that acts like a buffer between the sample and the ionizing probe. It also helps ionize the sample, carrying it along the flight tube so it can be detected.	`2,5-DHA (2,5-dihydroxyacetophenone)` `2,5-DHB (2,5-Dihydroxybenzoic acid)` `9-AA (9-aminoacridine)` `CHCA (alpha-cyano-4-hydroxy-cinnamic acid)` `DAN (1,5-diaminonapthalene)` `DMACA (4-(dimethylamino)cinnamic acid)` `NEDC (N-(1-naphthyl) ethylenediamine dihydrochloride)` `SA (sinapic acid)`
desorption_solvent *	Solvent composition for conducting nanospray desorption electrospray ionization (nanoDESI) or desorption electrospray ionization (DESI).	`Acetonitrile:Dimethylformamide (ACN:DMF)` `Acetonitrile:Water (ACN:H2O)` `Ethanol:Dimethylformamide (EtOH:DMF)` `Ethanol:Water (EtOH:H2O)` `Methanol:Ethanol (MeOH:EtOH)` `Methanol:Water (MeOH:H2O)`
desorption_solvent_flow_rate_value *	The rate of flow of the solvent into a spray.
desorption_solvent_flow_rate_unit *	Units of the rate of solvent flow.	`nL/min` `uL/min`
analysis_protocol_doi *	A DOI to a protocols.io protocol describing the software and database(s) used to process the raw data. Example: https://dx.doi.org/10.17504/protocols.io.bsu5ney6
metadata_schema_id *	The string that serves as the definitive identifier for the metadata schema version and is readily interpretable by computers for data validation and processing. Example: 22bc762a-5020-419d-b170-24253ed9e8d9

Deprecated Attributes

These attributes were supported by older metadata version specifications. They are no longer collected but there may be some older datasets that contain data for these attributes.

Attribute	Description	Allowable Values
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.	`sequence`
description	Free-text description of this assay.
overall_protocols_io_doi	DOI for protocols.io referring to the overall protocol for the assay.
donor_id	HuBMAP Display ID of the donor of the assayed tissue.
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.
operator	Name of the person responsible for executing the assay.
operator_email	Email address for the operator.
pi	Name of the principal investigator responsible for the data.
pi_email	Email address for the principal investigator.
resolution_x_unit	The unit of measurement of width of a pixel.(nm)	`mm` `um` `nm`
resolution_x_value	The width of a pixel. (Akoya pixel is 377nm square)
resolution_y_unit	The unit of measurement of height of a pixel. (nm)	`mm` `um` `nm`
resolution_y_value	The height of a pixel. (Akoya pixel is 377nm square)
version	Version of the schema to use when validating this metadata.	`1`