image_histology

Name	experimentSamples.Image_Histology.txt
JSON File Name	experimentSamples.Image_Histology.json
Type	combined-multiple
Schema Version	3.37
Description	The image histology experiment sample template defines and annotates the assay results for a sample by linking sample, experiment, and results together. The experiment samples template allows you to describe to ImmPort new experiments and biological samples or link experiments and biological samples stored in ImmPort with assay results. There is considerable flexibility in linking ImmPort content with new content in the templates and there are some general guidelines to remember. All of the experiment sample IDs in the template must always be unique in the template and must not already be stored in ImmPort. The biological sample and the experiment in the template may be new or they both may be new. If the biological sample or the experiment are new, then you must complete the required columns to describe them. The column header names in the templates indicate to what is being described and the '.xls' spreadsheet versions use color codes to indicate what is being described.
Download	⬇️ experimentSamples.Image_Histology.xlsx ⬇️ experimentSamples.Image_Histology.txt ⬇️ experimentSamples.Image_Histology.json This top-level schema references companion files (e.g. experimentSamples.Image_Histology.Datum.json) in the same json-templates folder — download the all_templates.zip to get them all together.

Reading this table: see How to read the template documentation for what Required / Conditionally required / Optional mean and how to read the Type & Constraints column.

Template Column	Requirement	Type & Constraints	Description
Study ID	Conditionally required when you are defining a new Biological Sample in this row (rather than referencing an existing one) and you are defining a new Experiment in this row (rather than referencing an existing one)	Text, max 15 characters Reference — must already exist (in this package or the workspace) as a study JSON: studyId (string)	An experiment and biological sample may be linked to a single study. Please enter either a study user defined ID or ImmPort accession. This column is only required when both the experiment and biological sample are new.
Expsample ID	Required	Text, max 100 characters JSON: expsampleId (string)	The experiment sample user defined ID is an identifier chosen by the data provider to refer to this sample. This ID may be referenced by other data records (e.g. assay results). The user defined ID is not shared. The identifier should be unique to the ImmPort workspace to which the data will be uploaded.
Reagent ID(s)	Conditionally required when you are defining a new Experiment Sample in this row (rather than referencing an existing one)	Text, max 15 characters Reference — must already exist (in this package or the workspace) as a reagent JSON: reagentIds (array)	One or more identifiers can be entered. Separate identifiers by semicolon (;). The reagent identifier(s) must be stored in ImmPort or in the reagents.txt template. Please enter either an assay reagent user defined ID or ImmPort accession.
Treatment ID(s)	Conditionally required when you are defining a new Experiment Sample in this row (rather than referencing an existing one)	Text, max 15 characters Reference — must already exist (in this package or the workspace) as a treatment JSON: treatmentIds (array)	One or more identifiers can be entered. Separate identifiers by semicolon (;). The treatment identifier(s) must be stored in ImmPort or in the treatments.txt template. Please enter either a treatment user defined ID or ImmPort accession.
Expsample Name	Optional	Text, max 200 characters JSON: expsampleName (string)	The experiment sample name is a display name that is available when the data is shared, but it is not referenced by other data records. The experiment sample name is an alternate identifier that is visible when the experiment sample is shared.
Expsample Description	Optional	Text, max 4000 characters JSON: expsampleDescription (string)	Describe important characteristics of the sample being assayed.
Additional Result File Names	Optional	JSON: additionalResultFileNames (array)	Separate file names by a semi-colon (;). The file size name limit is 240 characters. Please enter additional result file(s) to link to the experiment sample. The file size name limit is 240 characters.
Result File Name	Conditionally required when you are defining a new Experiment Sample in this row (rather than referencing an existing one)	JSON: resultFileName (string)	Enter the file name for this assay result. The file size name limit is 240 characters.
Biosample ID	Required	Text, max 100 characters JSON: biosampleId (string)	The biological sample user defined ID is an identifier chosen by the data provider to refer to a sample. This ID may be referenced by other data records (e.g. experiment sample). The user defined ID is not shared. The identifier should be unique to the ImmPort workspace to which the data will be uploaded. Please enter either a biological sample user defined ID or ImmPort accession. A single biological sample may be linked to an experiment sample.
Subject ID	Conditionally required when you are defining a new Biological Sample in this row (rather than referencing an existing one)	Text, max 15 characters Reference — must already exist (in this package or the workspace) as a subject JSON: subjectId (string)	Please enter either a subject user defined ID or ImmPort accession for the subject from which the sample was derived. A single subject record is permitted.
Planned Visit ID	Conditionally required when you are defining a new Biological Sample in this row (rather than referencing an existing one)	Text, max 15 characters Reference — must already exist (in this package or the workspace) as a planned_visit JSON: plannedVisitId (string)	The link to a study's planned visit provides temporal context for a sample's derivation from a subject. Please enter either a study's planned visit user defined ID or ImmPort accession.
Type	Conditionally required when you are defining a new Biological Sample in this row (rather than referencing an existing one)	Text, max 50 characters Controlled vocabulary — value must be one of lk_sample_type JSON: type (enum)	The sample types are adopted from Uberon, Cell and CHEBI ontologies. Please choose from the drop down list.
Subtype	Conditionally required when you are defining a new Biological Sample in this row (rather than referencing an existing one) and Type = "other"	Text, max 50 characters JSON: subtype (string)	Enter a sample type that is of finer resolution than the standard sample types provided. If the 'Biological Sample Type' is 'Other', then the sample subtype must be entered.
Biosample Name	Optional	Text, max 200 characters JSON: biosampleName (string)	The biological sample name is a display name that is available when the data is shared, but it is not referenced by other data. The biological sample name is an alternate identifier that is visible when the sample is shared.
Biosample Description	Optional	Text, max 4000 characters JSON: biosampleDescription (string)	The biological sample description is used to describe details of the sample not captured in other columns.
Study Time Collected	Conditionally required when you are defining a new Biological Sample in this row (rather than referencing an existing one)	Number JSON: studyTimeCollected (number)	Study time collected describes the time value for when a sample was derived from a subject. Please enter a number.
Study Time Collected Unit	Conditionally required when you are defining a new Biological Sample in this row (rather than referencing an existing one)	Text, max 25 characters Controlled vocabulary — value must be one of lk_time_unit JSON: studyTimeCollectedUnit (enum)	The time units are standard terms recommended by the HIPC Standards group. Please choose from the drop down list.
Study Time T0 Event	Conditionally required when you are defining a new Biological Sample in this row (rather than referencing an existing one)	Text, max 50 characters Controlled vocabulary — value must be one of lk_t0_event JSON: studyTimeT0Event (enum)	The time zero event refers to the study milestone upon which time is based. Please choose from the drop down list.
Study Time T0 Event Specify	Conditionally required when you are defining a new Biological Sample in this row (rather than referencing an existing one) and Study Time T0 Event = "other"	Text, max 50 characters JSON: studyTimeT0EventSpecify (string)	Enter a time zero event if 'Other' is selected in column 'Study Time T0 Event'.
Experiment ID	Required	Text, max 100 characters JSON: experimentId (string)	The experiment identifier must be stored in ImmPort or in the experiments.txt template. The experiment serves as the parent entity to bind assay results of a similar type together. Please enter either a experiment user defined ID or ImmPort accession.
Protocol ID(s)	Conditionally required when you are defining a new Experiment in this row (rather than referencing an existing one)	Text, max 15 characters Reference — must already exist (in this package or the workspace) as a protocol JSON: protocolIds (array)	Please enter either a protocol user defined ID or ImmPort accession for a protocol that describes how the sample was derived and prepared. One or more identifiers can be entered per sample. Separate identifiers by semicolon (;). Please enter either a protocol user defined ID or ImmPort accession. This column is required when either the experiment or biological sample are new.
Experiment Name	Conditionally required when you are defining a new Experiment in this row (rather than referencing an existing one)	Text, max 500 characters JSON: experimentName (string)	The experiment name is a display name that is available when the data is shared, but it is not referenced by other data. The experiment name is an alternate identifier that is visible when the sample is shared.
Experiment Description	Optional	Text, max 4000 characters JSON: experimentDescription (string)	The experiment description is used to describe details of the experiment not captured in other columns.
Measurement Technique	Conditionally required when you are defining a new Experiment in this row (rather than referencing an existing one)	Text, max 50 characters Controlled vocabulary — value must be one of lk_exp_measurement_tech JSON: measurementTechnique (enum)	The measurement technique describes the assay method. Choose from a drop down list.