Page History
Panel | ||||
---|---|---|---|---|
| ||||
|
Panel | ||
---|---|---|
| ||
Description
The assay file Assay File provides references to assay results including measurements, images, raw data files, derived data files, image files, and other file types. There can be multiple assay files Assay Files per study.
File Format
The nano-TAB assay file leverages the The ISA-TAB-Nano Assay File leverages the ISA-TAB file format, which is a horizontal-based spreadsheet format with column headers and row values. An example subset of this format is provided in TABLE 21. Please note, concepts specified within the bracket “\[ \]” are variables depending on the type of assay.The following table provides an example subset of this format. Concepts specified within the bracket “[ ]” are variables depending on the type of assay. Wiki Markup
TABLE 21: Example Subset of the Assay File Format
A | B | C |
---|
E |
---|
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="1e6cfa2c-176f-4fff-8e83-b3428619cb3b"><ac:plain-text-body><![CDATA[
Sample Name | Assay Name | Measurement Value[z-average(hydrodynamic diameter)] |
Unit |
]]></ac:plain-text-body></ac:structured-macro>
NCL-20- |
1 | size by DLS assay | 5.2 |
nm | |
NCL-20- |
2 | size by DLS assay | 8.6 |
nm |
Fields
Nano-TAB Extensions---In support of nano-TAB, the extensions and constraints in TABLE 2 were applied to the ISA-TAB assay file. One important extension is that nano-TAB allows the entry of summary data in the assay files through an optional field called Measurement Value.
...
According to the ISA-TAB specification, the assay file Assay File has different types of fields called nodes, attributes of nodes, qualifiers of nodes’ attributes, and other valid fields. The assay file In support of ISA-TAB-Nano, extensions were applied to the Assay File to record the endpoint value of an assay measurement (Measurement Value) as an attribute of the assay name.
The Assay File supports the following types of information:
- Source or sample Sample name
- Assay protocol reference and , protocol parameter valuesAssay name, performer, and date the assay protocol was performed
- Assay factor values including units and statistics, if applicable
- Assay name
- Assay measurement values including units and statisticsqualitifed by statistics, if applicable
- Raw Image files, raw data files, derived data files or image other files, if applicableapplicable
Nodes
Source Sample Name--- The unique identification name of the source sample, which is referred to from within the study file. This column is used only if the source is same as the sample in an assay. Source names can be qualified only using Comment.The sample is obtained after the application of a protocol. Sample names can be qualified with Material Types, Characteristics and/or Comments.
Assay Sample Name---The unique identification name of the sample, which is referred to from within the study file. The sample is obtained after the application of a protocol. Sample names can be qualified only using Comment.assay performed. This name is an identifier within the assay file.
Image FileImage file---The name or URI of an image file generated from an assay.
Raw data fileData File---The name or URI of the raw data files.
D erived data fileData File---The name or URI of the file resulting from data transformation or processing.
Attributes of Assay Nodes
assay nodes---One or more attributes are can be used to provide more information about a assay node. The different assay node attributes are described below:
Material typeType---An attribute for the sample name (e.g. Sample Name (for example, biospecimen, nanoparticle sample, small molecule etc.) if the same attribute is not given in the study Study file. The term can be a free-text description or taken from an ontology or a controlled vocabulary. If it is the latter, then the following qualifiers are used: term accession number and term source REF.
_Characteristic \[ \]_\Characteristics [ ]---An attribute for _sample name_ if the same attribute is not given in the study file.Assay name---The name of the assay performed. This name is used as an identifier within the assay for Sample Name if the same attribute is not given in the study file. Wiki Markup
Attributes of Processing Events for Assay Nodes
One or more attributes are can be used to describe a step in the assay of a sample.
Protocol REF--- The name of the protocol used to perform the experiment. This name should be obtained from a value for the field study protocol name in the investigation file. Protocol REF can be further described using the following fields:
Parameter Value [ ]--- Value of a parameter, which is an intrinsic experimental condition that may be varied or constant, when applying a protocol. The parameter term is written within brackets and must match the term used as value for the study protocol parameter name in the investigation file.
Performer---The name of the person who carried out the protocol.
Date---The calendar day on which the protocol was carried out.
...
The date format should be in YYYY-MM-DD.
...
Attribute of Assay Name
One or more attributes can be used to record the assay endpoints.
Factor Value [ ]---The value of an independent variable manipulated by the experimentalist with the intention to affect the subject of study (that is, stressor). Factor terms are given in brackets, and must be defined in the ISA-TAB-Nano investigation file in the STUDY FACTORS section. Factor Value [] in the Assay file should reference technical variations (such as software, instrument or protocol variations).
Measurement Value [statistic(measurement name)]---The endpoint of the assay. Measurement value names are described in brackets or parenthesis if a statistics (such as mean, standard deviation) is applied to the measurement (Syntax: Measurement Value[statistic(<measurement name>)]). A statistic is only required for statistical measures
Wiki Markup |
---|
_Parameter value\[<parameter term\]_\--\- Value of a parameter, which is kept constant, when applying a protocol. The parameter term is written within brackets and must match the term used as value for the _study protocol parameter name_ in the investigation file. |
_Measurement value_ \[<measurement term>\]---The endpoint of the assay. This field is used to capture measurement outputs recorded in summary data. Wiki Markup
Qualifiers for Assay Nodes’ Attributes
Each node attribute may be qualified using the following concepts, if applicable.unmigrated-wiki-markup
_Unit_\---The standard of measurement used if the values for _characteristic_ \ [ \ ], _parameter value \[ \]_ or _factor value \[ \]_ columns are quantitative and dimensional. If the term for _unit_ is taken from an ontology/controlled vocabulary, then its _term accession number_ and the _term source REF_ should be defined in the nano-TAB investigation file. parameter value [ ], factor value [ ], or measurement value [ ] columns are quantitative and dimensional. If the term for unit is from an ontology/controlled vocabulary, then its term accession number and the term source REF should be defined in the ISA-TAB-Nano Assay File.
Term Accession Number---Identification number of a term selected from an ontology or a controlled vocabulary, if the term is entered as a value in material type, characteristics [ ], parameter value [ ], measurement value [], unit or factor value [ ] _Term Accession Number_\---Identification number of a term selected from an ontology or a controlled vocabulary, if the term is entered as a value in _source name_, _material type,_ _characteristic \[ \]_, _parameter value \[ \]_, _unit_ or _factor value \[ \]_ columns. Wiki Markup
Term Source REF---The name which identifies the source from where a term is selected and entered in nanoISA-TAB-Nano study files. This name should match one of the names entered in the term source name field in the nanoISA-TAB investigation file.
Statistic---The type of statistical measure attributed to a numerical value (e.g., mean, standard deviation, z-average, etc.). This is a required field, if the parameter value, factor value, or measurement value is a statistical measure.
Other Assay Fields
Wiki Markup |
---|
_Factor Value\[<factor name>\]_\---The value of an independent variable manipulated by the experimentalist with the intention to affect the subject of study (i.e. stressor). Factor terms are given in brackets, and must be defined in the nano-TAB investigation file in the STUDY FACTORS section. Factor Value\[\] in assay file should reference technical variations (such as software, instrument or protocol variations). |
-Nano Investigation File.
Other Assay Fields
Comment [ ]---Any comment that provides additional information, which is added only when no other appropriate field exists. Comment fields should be attached to the closest node or the field.
Files
The following pages provide the assay file examples, template, and glossary: _Comment\[\]_\---Any comment that provides additional information, which is added only when no other appropriate field exists. Wiki Markup