# Clinical Analysis

## Overview

Created by pfurio on 05/06/17.

### Summary

| Field                    |                                         Create                                        |                                         Update                                        |                                         Unique                                        |                                        Required                                       |
| ------------------------ | :-----------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------: |
| id                       | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) |
| description              | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |
| type                     | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |
| disorder                 | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |
| files                    | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |
| proband                  | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |
| family                   | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |
| panels                   | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |
| panelLock                | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |
| locked                   | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |
| interpretation           | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |
| secondaryInterpretations | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |
| consent                  | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |
| analyst                  | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |
| priority                 | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |
| flags                    | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |
| dueDate                  | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |
| qualityControl           | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |
| comments                 | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |
| audit                    | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |
| attributes               | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |
| status                   | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |
| uuid                     |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) | ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/yes.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |
| creationDate             |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |
| modificationDate         |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |
| release                  |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |
| internal                 |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |  ![](https://github.com/opencb/opencga/blob/develop/docs/data-models/no.png?raw=true) |

## Data Model

### ClinicalAnalysis

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/clinical/ClinicalAnalysis.java).

| Field                                                                                                                               | Description                                                                                                                                                                                                       |
| ----------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong>id</strong><br><em>String</em><br></p>                                                                                   | <p>ClinicalAnalysis ID is a mandatory parameter when creating a new ClinicalAnalysis, this ID cannot be changed at the moment.</p><p><em>Tags</em>: <em>required, immutable, unique</em></p>                      |
| <p><strong>uuid</strong><br><em>String</em><br></p>                                                                                 | <p>Global unique ID at the whole OpenCGA installation. This is automatically created during the ClinicalAnalysis creation and cannot be<br>changed.</p><p><em>Tags</em>: <em>internal, unique, immutable</em></p> |
| <p><strong>description</strong><br><em>String</em><br></p>                                                                          | An string to describe the properties of the ClinicalAnalysis.                                                                                                                                                     |
| <p><strong>type</strong><br><a href="#enum-clinicalanalysistype"><em>ClinicalAnalysis.Type</em></a><br></p>                         |                                                                                                                                                                                                                   |
| <p><strong>disorder</strong><br><em>Disorder</em><br></p>                                                                           |                                                                                                                                                                                                                   |
| <p><strong>files</strong><br>List<<a href="#File"><em>File</em></a>><br></p>                                                        |                                                                                                                                                                                                                   |
| <p><strong>proband</strong><br><a href="#Individual"><em>Individual</em></a><br></p>                                                |                                                                                                                                                                                                                   |
| <p><strong>family</strong><br><a href="#Family"><em>Family</em></a><br></p>                                                         |                                                                                                                                                                                                                   |
| <p><strong>panels</strong><br>List<<a href="#Panel"><em>Panel</em></a>><br></p>                                                     |                                                                                                                                                                                                                   |
| <p><strong>panelLock</strong><br><em>boolean</em><br></p>                                                                           |                                                                                                                                                                                                                   |
| <p><strong>locked</strong><br><em>boolean</em><br></p>                                                                              |                                                                                                                                                                                                                   |
| <p><strong>interpretation</strong><br><a href="#Interpretation"><em>Interpretation</em></a><br></p>                                 |                                                                                                                                                                                                                   |
| <p><strong>secondaryInterpretations</strong><br>List<<a href="#Interpretation"><em>Interpretation</em></a>><br></p>                 |                                                                                                                                                                                                                   |
| <p><strong>consent</strong><br><a href="#ClinicalConsentAnnotation"><em>ClinicalConsentAnnotation</em></a><br></p>                  |                                                                                                                                                                                                                   |
| <p><strong>analyst</strong><br><em>ClinicalAnalyst</em><br></p>                                                                     |                                                                                                                                                                                                                   |
| <p><strong>priority</strong><br><a href="#ClinicalPriorityAnnotation"><em>ClinicalPriorityAnnotation</em></a><br></p>               |                                                                                                                                                                                                                   |
| <p><strong>flags</strong><br>List<<a href="#FlagAnnotation"><em>FlagAnnotation</em></a>><br></p>                                    |                                                                                                                                                                                                                   |
| <p><strong>creationDate</strong><br><em>String</em><br></p>                                                                         | <p>String representing when the sample was created, this is automatically set by OpenCGA.</p><p><em>Tags</em>: <em>internal</em></p>                                                                              |
| <p><strong>modificationDate</strong><br><em>String</em><br></p>                                                                     | <p>String representing when was the last time the sample was modified, this is automatically set by OpenCGA.</p><p><em>Tags</em>: <em>internal</em></p>                                                           |
| <p><strong>dueDate</strong><br><em>String</em><br></p>                                                                              |                                                                                                                                                                                                                   |
| <p><strong>release</strong><br><em>int</em><br></p>                                                                                 | <p>An integer describing the current data release.</p><p><em>Tags</em>: <em>internal</em></p>                                                                                                                     |
| <p><strong>qualityControl</strong><br><a href="#ClinicalAnalysisQualityControl"><em>ClinicalAnalysisQualityControl</em></a><br></p> |                                                                                                                                                                                                                   |
| <p><strong>comments</strong><br>List<<em>ClinicalComment</em>><br></p>                                                              |                                                                                                                                                                                                                   |
| <p><strong>audit</strong><br>List<<em>ClinicalAudit</em>><br></p>                                                                   |                                                                                                                                                                                                                   |
| <p><strong>internal</strong><br><a href="#ClinicalAnalysisInternal"><em>ClinicalAnalysisInternal</em></a><br></p>                   | <p>An object describing the internal information of the ClinicalAnalysis. This is managed by OpenCGA.</p><p><em>Tags</em>: <em>internal</em></p>                                                                  |
| <p><strong>attributes</strong><br>Map<<em>Object</em>,<em>String</em>><br></p>                                                      | You can use this field to store any other information, keep in mind this is not indexed so you cannot search by attributes.                                                                                       |
| <p><strong>status</strong><br><em>Status</em><br></p>                                                                               | An object describing the status of the ClinicalAnalysis.                                                                                                                                                          |

### File

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/file/File.java).

| Field                                                                                                       | Description                                                                                                                                                                                        |
| ----------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong>id</strong><br><em>String</em><br></p>                                                           | <p>File ID is a mandatory parameter when creating a new File, this ID cannot be changed at the moment.</p><p><em>Tags</em>: <em>required, immutable, unique</em></p>                               |
| <p><strong>uuid</strong><br><em>String</em><br></p>                                                         | <p>Global unique ID at the whole OpenCGA installation. This is automatically created during the File creation and cannot be changed.</p><p><em>Tags</em>: <em>internal, unique, immutable</em></p> |
| <p><strong>name</strong><br><em>String</em><br></p>                                                         |                                                                                                                                                                                                    |
| <p><strong>type</strong><br><a href="#enum-filetype"><em>File.Type</em></a><br></p>                         | Formats: file, folder, index.                                                                                                                                                                      |
| <p><strong>format</strong><br><a href="#enum-fileformat"><em>File.Format</em></a><br></p>                   | Formats: txt, executable, image, ...                                                                                                                                                               |
| <p><strong>bioformat</strong><br><a href="#enum-filebioformat"><em>File.Bioformat</em></a><br></p>          | BAM, VCF, ...                                                                                                                                                                                      |
| <p><strong>checksum</strong><br><em>String</em><br></p>                                                     |                                                                                                                                                                                                    |
| <p><strong>uri</strong><br><em>URI</em><br></p>                                                             |                                                                                                                                                                                                    |
| <p><strong>path</strong><br><em>String</em><br></p>                                                         |                                                                                                                                                                                                    |
| <p><strong>release</strong><br><em>int</em><br></p>                                                         | <p>An integer describing the current data release.</p><p><em>Tags</em>: <em>internal</em></p>                                                                                                      |
| <p><strong>creationDate</strong><br><em>String</em><br></p>                                                 | <p>String representing when the File was created, this is automatically set by OpenCGA.</p><p><em>Tags</em>: <em>internal</em></p>                                                                 |
| <p><strong>modificationDate</strong><br><em>String</em><br></p>                                             | <p>String representing when was the last time the File was modified, this is automatically set by OpenCGA.</p><p><em>Tags</em>: <em>internal</em></p>                                              |
| <p><strong>description</strong><br><em>String</em><br></p>                                                  | An string to describe the properties of the File.                                                                                                                                                  |
| <p><strong>external</strong><br><em>boolean</em><br></p>                                                    |                                                                                                                                                                                                    |
| <p><strong>size</strong><br><em>long</em><br></p>                                                           |                                                                                                                                                                                                    |
| <p><strong>software</strong><br><em>Software</em><br></p>                                                   |                                                                                                                                                                                                    |
| <p><strong>experiment</strong><br><a href="#FileExperiment"><em>FileExperiment</em></a><br></p>             |                                                                                                                                                                                                    |
| <p><strong>sampleIds</strong><br>List<<em>String</em>><br></p>                                              |                                                                                                                                                                                                    |
| <p><strong>jobId</strong><br><em>String</em><br></p>                                                        |                                                                                                                                                                                                    |
| <p><strong>tags</strong><br>List<<em>String</em>><br></p>                                                   |                                                                                                                                                                                                    |
| <p><strong>relatedFiles</strong><br>List<<a href="#FileRelatedFile"><em>FileRelatedFile</em></a>><br></p>   |                                                                                                                                                                                                    |
| <p><strong>qualityControl</strong><br><a href="#FileQualityControl"><em>FileQualityControl</em></a><br></p> |                                                                                                                                                                                                    |
| <p><strong>stats</strong><br>Map<<em>Object</em>,<em>String</em>><br></p>                                   |                                                                                                                                                                                                    |
| <p><strong>status</strong><br><a href="#CustomStatus"><em>CustomStatus</em></a><br></p>                     | An object describing the status of the File.                                                                                                                                                       |
| <p><strong>internal</strong><br><a href="#FileInternal"><em>FileInternal</em></a><br></p>                   | <p>An object describing the internal information of the File. This is managed by OpenCGA.</p><p><em>Tags</em>: <em>internal</em></p>                                                               |
| <p><strong>attributes</strong><br>Map<<em>Object</em>,<em>String</em>><br></p>                              | You can use this field to store any other information, keep in mind this is not indexed so you cannot search by attributes.                                                                        |

### FileExperiment

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/file/FileExperiment.java).

| Field                                                                                                                                    | Description |
| ---------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| <p><strong>technology</strong><br><a href="#enum-fileexperimenttechnology"><em>FileExperiment.Technology</em></a><br></p>                |             |
| <p><strong>method</strong><br><a href="#enum-fileexperimentmethod"><em>FileExperiment.Method</em></a><br></p>                            |             |
| <p><strong>nucleicAcidType</strong><br><a href="#enum-fileexperimentnucleicacidtype"><em>FileExperiment.NucleicAcidType</em></a><br></p> |             |
| <p><strong>manufacturer</strong><br><em>String</em><br></p>                                                                              |             |
| <p><strong>platform</strong><br><em>String</em><br></p>                                                                                  |             |
| <p><strong>library</strong><br><em>String</em><br></p>                                                                                   |             |
| <p><strong>date</strong><br><em>String</em><br></p>                                                                                      |             |
| <p><strong>center</strong><br><em>String</em><br></p>                                                                                    |             |
| <p><strong>lab</strong><br><em>String</em><br></p>                                                                                       |             |
| <p><strong>responsible</strong><br><em>String</em><br></p>                                                                               |             |
| <p><strong>description</strong><br><em>String</em><br></p>                                                                               |             |
| <p><strong>attributes</strong><br>Map<<em>Object</em>,<em>String</em>><br></p>                                                           |             |

### Enum FileExperiment.Method

*Enumeration class.* You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/file/FileExperiment/Method.java).

| Field                                                 | Description |
| ----------------------------------------------------- | ----------- |
| <p><strong>WHOLE\_EXOME\_SEQUENCING</strong><br></p>  |             |
| <p><strong>WHOLE\_GENOME\_SEQUENCING</strong><br></p> |             |
| <p><strong>TARGETED\_DNA\_SEQUENCING</strong><br></p> |             |
| <p><strong>AMPLICON\_SEQUENCING</strong><br></p>      |             |
| <p><strong>GENOTYPING\_MICROARRAY</strong><br></p>    |             |

### Enum FileExperiment.NucleicAcidType

*Enumeration class.* You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/file/FileExperiment/NucleicAcidType.java).

| Field                           | Description |
| ------------------------------- | ----------- |
| <p><strong>DNA</strong><br></p> |             |
| <p><strong>RNA</strong><br></p> |             |

### Enum FileExperiment.Technology

*Enumeration class.* You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/file/FileExperiment/Technology.java).

| Field                                  | Description |
| -------------------------------------- | ----------- |
| <p><strong>SEQUENCING</strong><br></p> |             |
| <p><strong>MICROARRAY</strong><br></p> |             |

### CustomStatus

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/common/CustomStatus.java).

| Field                                                      | Description                                                                                                                                                                                                                                    |
| ---------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong>name</strong><br><em>String</em><br></p>        | <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed vestibulum aliquet lobortis. Pellentesque venenatis lacus quis nibh<br>interdum finibus.</p><p><em>Tags</em>: <em>required, immutable</em></p>                                 |
| <p><strong>description</strong><br><em>String</em><br></p> | <p>Proin aliquam ante in ligula tincidunt, cursus volutpat urna suscipit. Phasellus interdum, libero at posuere blandit, felis dui<br>dignissim leo, quis ullamcorper felis elit a augue.</p><p><em>Tags</em>: <em>required</em></p>           |
| <p><strong>date</strong><br><em>String</em><br></p>        | <p>Nullam commodo tortor nec lectus cursus finibus. Sed quis orci fringilla, cursus diam quis, vehicula sapien. Etiam bibendum dapibus<br>lectus, ut ultrices nunc vulputate ac.</p><p><em>Tags</em>: <em>internal, unique, immutable</em></p> |

### Enum File.Format

*Enumeration class.* You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/file/File/Format.java).

| Field                                                | Description |
| ---------------------------------------------------- | ----------- |
| <p><strong>VCF</strong><br></p>                      |             |
| <p><strong>BCF</strong><br></p>                      |             |
| <p><strong>GVCF</strong><br></p>                     |             |
| <p><strong>TBI</strong><br></p>                      |             |
| <p><strong>BIGWIG</strong><br></p>                   |             |
| <p><strong>SAM</strong><br></p>                      |             |
| <p><strong>BAM</strong><br></p>                      |             |
| <p><strong>BAI</strong><br></p>                      |             |
| <p><strong>CRAM</strong><br></p>                     |             |
| <p><strong>CRAI</strong><br></p>                     |             |
| <p><strong>FASTQ</strong><br></p>                    |             |
| <p><strong>FASTA</strong><br></p>                    |             |
| <p><strong>PED</strong><br></p>                      |             |
| <p><strong>TAB\_SEPARATED\_VALUES</strong><br></p>   |             |
| <p><strong>COMMA\_SEPARATED\_VALUES</strong><br></p> |             |
| <p><strong>XML</strong><br></p>                      |             |
| <p><strong>PROTOCOL\_BUFFER</strong><br></p>         |             |
| <p><strong>JSON</strong><br></p>                     |             |
| <p><strong>AVRO</strong><br></p>                     |             |
| <p><strong>PARQUET</strong><br></p>                  |             |
| <p><strong>IMAGE</strong><br></p>                    |             |
| <p><strong>PLAIN</strong><br></p>                    |             |
| <p><strong>BINARY</strong><br></p>                   |             |
| <p><strong>NONE</strong><br></p>                     |             |
| <p><strong>UNKNOWN</strong><br></p>                  |             |

### FileQualityControl

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/file/FileQualityControl.java).

| Field                                                                                                                    | Description |
| ------------------------------------------------------------------------------------------------------------------------ | ----------- |
| <p><strong>variant</strong><br><a href="#VariantFileQualityControl"><em>VariantFileQualityControl</em></a><br></p>       |             |
| <p><strong>alignment</strong><br><a href="#AlignmentFileQualityControl"><em>AlignmentFileQualityControl</em></a><br></p> |             |
| <p><strong>coverage</strong><br><a href="#CoverageFileQualityControl"><em>CoverageFileQualityControl</em></a><br></p>    |             |
| <p><strong>comments</strong><br>List<<em>ClinicalComment</em>><br></p>                                                   |             |

### AlignmentFileQualityControl

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/alignment/AlignmentFileQualityControl.java).

| Field                                                                       | Description |
| --------------------------------------------------------------------------- | ----------- |
| <p><strong>fastQcMetrics</strong><br><em>FastQcMetrics</em><br></p>         |             |
| <p><strong>samtoolsStats</strong><br><em>SamtoolsStats</em><br></p>         |             |
| <p><strong>samtoolsFlagStats</strong><br><em>SamtoolsFlagstats</em><br></p> |             |
| <p><strong>hsMetrics</strong><br><em>HsMetrics</em><br></p>                 |             |

### CoverageFileQualityControl

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/alignment/CoverageFileQualityControl.java).

| Field                                                                             | Description |
| --------------------------------------------------------------------------------- | ----------- |
| <p><strong>geneCoverageStats</strong><br>List<<em>GeneCoverageStats</em>><br></p> |             |

### VariantFileQualityControl

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/variant/VariantFileQualityControl.java).

| Field                                                                     | Description |
| ------------------------------------------------------------------------- | ----------- |
| <p><strong>variantSetMetrics</strong><br><em>VariantSetStats</em><br></p> |             |
| <p><strong>ascatMetrics</strong><br><em>AscatMetrics</em><br></p>         |             |

### FileRelatedFile

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/file/FileRelatedFile.java).

| Field                                                                                                                 | Description |
| --------------------------------------------------------------------------------------------------------------------- | ----------- |
| <p><strong>file</strong><br><a href="#File"><em>File</em></a><br></p>                                                 |             |
| <p><strong>relation</strong><br><a href="#enum-filerelatedfilerelation"><em>FileRelatedFile.Relation</em></a><br></p> |             |

### Enum FileRelatedFile.Relation

*Enumeration class.* You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/file/FileRelatedFile/Relation.java).

| Field                                         | Description |
| --------------------------------------------- | ----------- |
| <p><strong>PRODUCED\_FROM</strong><br></p>    |             |
| <p><strong>PART\_OF\_PAIR</strong><br></p>    |             |
| <p><strong>PEDIGREE</strong><br></p>          |             |
| <p><strong>REFERENCE\_GENOME</strong><br></p> |             |

### Enum File.Type

*Enumeration class.* You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/file/File/Type.java).

| Field                                 | Description |
| ------------------------------------- | ----------- |
| <p><strong>FILE</strong><br></p>      |             |
| <p><strong>DIRECTORY</strong><br></p> |             |

### Enum File.Bioformat

*Enumeration class.* You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/file/File/Bioformat.java).

| Field                                                                      | Description |
| -------------------------------------------------------------------------- | ----------- |
| <p><strong>MICROARRAY\_EXPRESSION\_ONECHANNEL\_AGILENT</strong><br></p>    |             |
| <p><strong>MICROARRAY\_EXPRESSION\_ONECHANNEL\_AFFYMETRIX</strong><br></p> |             |
| <p><strong>MICROARRAY\_EXPRESSION\_ONECHANNEL\_GENEPIX</strong><br></p>    |             |
| <p><strong>MICROARRAY\_EXPRESSION\_TWOCHANNELS\_AGILENT</strong><br></p>   |             |
| <p><strong>MICROARRAY\_EXPRESSION\_TWOCHANNELS\_GENEPIX</strong><br></p>   |             |
| <p><strong>DATAMATRIX\_EXPRESSION</strong><br></p>                         |             |
| <p><strong>IDLIST</strong><br></p>                                         |             |
| <p><strong>IDLIST\_RANKED</strong><br></p>                                 |             |
| <p><strong>ANNOTATION\_GENEVSANNOTATION</strong><br></p>                   |             |
| <p><strong>OTHER\_NEWICK</strong><br></p>                                  |             |
| <p><strong>OTHER\_BLAST</strong><br></p>                                   |             |
| <p><strong>OTHER\_INTERACTION</strong><br></p>                             |             |
| <p><strong>OTHER\_GENOTYPE</strong><br></p>                                |             |
| <p><strong>OTHER\_PLINK</strong><br></p>                                   |             |
| <p><strong>OTHER\_VCF</strong><br></p>                                     |             |
| <p><strong>OTHER\_PED</strong><br></p>                                     |             |
| <p><strong>VCF4</strong><br></p>                                           |             |
| <p><strong>VARIANT</strong><br></p>                                        |             |
| <p><strong>ALIGNMENT</strong><br></p>                                      |             |
| <p><strong>COVERAGE</strong><br></p>                                       |             |
| <p><strong>SEQUENCE</strong><br></p>                                       |             |
| <p><strong>PEDIGREE</strong><br></p>                                       |             |
| <p><strong>REFERENCE\_GENOME</strong><br></p>                              |             |
| <p><strong>NONE</strong><br></p>                                           |             |
| <p><strong>UNKNOWN</strong><br></p>                                        |             |

### FileInternal

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/file/FileInternal.java).

| Field                                                                                               | Description |
| --------------------------------------------------------------------------------------------------- | ----------- |
| <p><strong>status</strong><br><a href="#FileStatus"><em>FileStatus</em></a><br></p>                 |             |
| <p><strong>index</strong><br><a href="#FileIndex"><em>FileIndex</em></a><br></p>                    |             |
| <p><strong>sampleMap</strong><br>Map<<em>String</em>><br></p>                                       |             |
| <p><strong>missingSamples</strong><br><a href="#MissingSamples"><em>MissingSamples</em></a><br></p> |             |

### FileIndex

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/file/FileIndex.java).

| Field                                                                                                                     | Description |
| ------------------------------------------------------------------------------------------------------------------------- | ----------- |
| <p><strong>userId</strong><br><em>String</em><br></p>                                                                     |             |
| <p><strong>creationDate</strong><br><em>String</em><br></p>                                                               |             |
| <p><strong>status</strong><br><a href="#fileindexindexstatus"><em>FileIndex.IndexStatus</em></a><br></p>                  |             |
| <p><strong>jobId</strong><br><em>long</em><br></p>                                                                        |             |
| <p><strong>release</strong><br><em>long</em><br></p>                                                                      |             |
| <p><strong>transformedFile</strong><br><a href="#fileindextransformedfile"><em>FileIndex.TransformedFile</em></a><br></p> |             |
| <p><strong>localFileIndex</strong><br><a href="#fileindexlocalfileindex"><em>FileIndex.LocalFileIndex</em></a><br></p>    |             |
| <p><strong>attributes</strong><br>Map<<em>Object</em>,<em>String</em>><br></p>                                            |             |

### FileIndex.TransformedFile

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/file/FileIndex/TransformedFile.java).

| Field                                                   | Description |
| ------------------------------------------------------- | ----------- |
| <p><strong>id</strong><br><em>long</em><br></p>         |             |
| <p><strong>metadataId</strong><br><em>long</em><br></p> |             |

### FileIndex.LocalFileIndex

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/file/FileIndex/LocalFileIndex.java).

| Field                                                  | Description |
| ------------------------------------------------------ | ----------- |
| <p><strong>fileId</strong><br><em>long</em><br></p>    |             |
| <p><strong>indexer</strong><br><em>String</em><br></p> |             |

### FileIndex.IndexStatus

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/file/FileIndex/IndexStatus.java).

| Field                                                       | Description |
| ----------------------------------------------------------- | ----------- |
| <p><strong>NONE</strong><br><em>String</em><br></p>         |             |
| <p><strong>TRANSFORMING</strong><br><em>String</em><br></p> |             |
| <p><strong>TRANSFORMED</strong><br><em>String</em><br></p>  |             |
| <p><strong>LOADING</strong><br><em>String</em><br></p>      |             |
| <p><strong>INDEXING</strong><br><em>String</em><br></p>     |             |
| <p><strong>STATUS\_LIST</strong><br>List><br></p>           |             |

### FileStatus

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/file/FileStatus.java).

| Field                                                             | Description                                                                                          |
| ----------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| <p><strong>TRASHED</strong><br><em>String</em><br></p>            | TRASHED name means that the object is marked as deleted although is still available in the database. |
| <p><strong>STAGE</strong><br><em>String</em><br></p>              |                                                                                                      |
| <p><strong>MISSING</strong><br><em>String</em><br></p>            |                                                                                                      |
| <p><strong>PENDING\_DELETE</strong><br><em>String</em><br></p>    |                                                                                                      |
| <p><strong>DELETING</strong><br><em>String</em><br></p>           |                                                                                                      |
| <p><strong>REMOVED</strong><br><em>String</em><br></p>            |                                                                                                      |
| <p><strong>MISSING\_SAMPLES</strong><br><em>String</em><br></p>   |                                                                                                      |
| <p><strong>STATUS\_LIST</strong><br>List<<em>String</em>><br></p> |                                                                                                      |

### MissingSamples

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/file/MissingSamples.java).

| Field                                                            | Description |
| ---------------------------------------------------------------- | ----------- |
| <p><strong>existing</strong><br>List<<em>String</em>><br></p>    |             |
| <p><strong>nonExisting</strong><br>List<<em>String</em>><br></p> |             |

### Family

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/family/Family.java).

| Field                                                                                                           | Description                                                                                                                                                                                          |
| --------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong>id</strong><br><em>String</em><br></p>                                                               | <p>Family is a mandatory parameter when creating a new sample, this ID cannot be changed at the moment.</p><p><em>Tags</em>: <em>required, immutable, unique</em></p>                                |
| <p><strong>uuid</strong><br><em>String</em><br></p>                                                             | <p>Global unique ID at the whole OpenCGA installation. This is automatically created during the Family creation and cannot be changed.</p><p><em>Tags</em>: <em>internal, unique, immutable</em></p> |
| <p><strong>name</strong><br><em>String</em><br></p>                                                             |                                                                                                                                                                                                      |
| <p><strong>members</strong><br>List<<a href="#Individual"><em>Individual</em></a>><br></p>                      |                                                                                                                                                                                                      |
| <p><strong>phenotypes</strong><br>List<<em>Phenotype</em>><br></p>                                              |                                                                                                                                                                                                      |
| <p><strong>disorders</strong><br>List<<em>Disorder</em>><br></p>                                                |                                                                                                                                                                                                      |
| <p><strong>qualityControl</strong><br><a href="#FamilyQualityControl"><em>FamilyQualityControl</em></a><br></p> |                                                                                                                                                                                                      |
| <p><strong>creationDate</strong><br><em>String</em><br></p>                                                     | <p>String representing when the Family was created, this is automatically set by OpenCGA.</p><p><em>Tags</em>: <em>internal</em></p>                                                                 |
| <p><strong>modificationDate</strong><br><em>String</em><br></p>                                                 | <p>String representing when was the last time the Family was modified, this is automatically set by OpenCGA.</p><p><em>Tags</em>: <em>internal</em></p>                                              |
| <p><strong>expectedSize</strong><br><em>int</em><br></p>                                                        |                                                                                                                                                                                                      |
| <p><strong>description</strong><br><em>String</em><br></p>                                                      | An string to describe the properties of the Family.                                                                                                                                                  |
| <p><strong>release</strong><br><em>int</em><br></p>                                                             | <p>An integer describing the current data release.</p><p><em>Tags</em>: <em>internal</em></p>                                                                                                        |
| <p><strong>version</strong><br><em>int</em><br></p>                                                             | <p>An integer describing the current version.</p><p><em>Tags</em>: <em>internal</em></p>                                                                                                             |
| <p><strong>status</strong><br><a href="#CustomStatus"><em>CustomStatus</em></a><br></p>                         | An object describing the status of the Family.                                                                                                                                                       |
| <p><strong>internal</strong><br><a href="#FamilyInternal"><em>FamilyInternal</em></a><br></p>                   | <p>An object describing the internal information of the Family. This is managed by OpenCGA.</p><p><em>Tags</em>: <em>internal</em></p>                                                               |
| <p><strong>roles</strong><br>Map<<em>MapString</em>,<em>String</em>,<em>FamiliarRelationship</em>><br></p>      |                                                                                                                                                                                                      |
| <p><strong>attributes</strong><br>Map<<em>Object</em>,<em>String</em>><br></p>                                  | You can use this field to store any other information, keep in mind this is not indexed so you cannot search by attributes.                                                                          |

### FamilyQualityControl

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/family/FamilyQualityControl.java).

| Field                                                                       | Description |
| --------------------------------------------------------------------------- | ----------- |
| <p><strong>relatedness</strong><br>List<<em>RelatednessReport</em>><br></p> |             |
| <p><strong>fileIds</strong><br>List<<em>String</em>><br></p>                |             |
| <p><strong>comments</strong><br>List<<em>ClinicalComment</em>><br></p>      |             |

### Individual

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/individual/Individual.java).

| Field                                                                                                                   | Description                                                                                                                                                                                                                                                                       |
| ----------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong>id</strong><br><em>String</em><br></p>                                                                       | <p>Individual ID in the study, this must be unique in the study but can be repeated in different studies. This is a mandatory parameter<br>when creating a new Individual, this ID cannot be changed at the moment.</p><p><em>Tags</em>: <em>required, immutable, unique</em></p> |
| <p><strong>uuid</strong><br><em>String</em><br></p>                                                                     | <p>Global unique ID at the whole OpenCGA installation. This is automatically created during the sample creation and cannot be changed.</p><p><em>Tags</em>: <em>internal, unique, immutable</em></p>                                                                              |
| <p><strong>name</strong><br><em>String</em><br></p>                                                                     |                                                                                                                                                                                                                                                                                   |
| <p><strong>father</strong><br><a href="#Individual"><em>Individual</em></a><br></p>                                     |                                                                                                                                                                                                                                                                                   |
| <p><strong>mother</strong><br><a href="#Individual"><em>Individual</em></a><br></p>                                     |                                                                                                                                                                                                                                                                                   |
| <p><strong>familyIds</strong><br>List<<em>String</em>><br></p>                                                          |                                                                                                                                                                                                                                                                                   |
| <p><strong>location</strong><br><a href="#Location"><em>Location</em></a><br></p>                                       |                                                                                                                                                                                                                                                                                   |
| <p><strong>qualityControl</strong><br><a href="#IndividualQualityControl"><em>IndividualQualityControl</em></a><br></p> |                                                                                                                                                                                                                                                                                   |
| <p><strong>sex</strong><br><em>Sex</em><br></p>                                                                         |                                                                                                                                                                                                                                                                                   |
| <p><strong>karyotypicSex</strong><br><em>KaryotypicSex</em><br></p>                                                     |                                                                                                                                                                                                                                                                                   |
| <p><strong>ethnicity</strong><br><em>String</em><br></p>                                                                |                                                                                                                                                                                                                                                                                   |
| <p><strong>population</strong><br><a href="#IndividualPopulation"><em>IndividualPopulation</em></a><br></p>             |                                                                                                                                                                                                                                                                                   |
| <p><strong>dateOfBirth</strong><br><em>String</em><br></p>                                                              |                                                                                                                                                                                                                                                                                   |
| <p><strong>release</strong><br><em>int</em><br></p>                                                                     | <p>An integer describing the current data release.</p><p><em>Tags</em>: <em>internal</em></p>                                                                                                                                                                                     |
| <p><strong>version</strong><br><em>int</em><br></p>                                                                     | <p>An integer describing the current version.</p><p><em>Tags</em>: <em>internal</em></p>                                                                                                                                                                                          |
| <p><strong>creationDate</strong><br><em>String</em><br></p>                                                             | <p>String representing when the sample was created, this is automatically set by OpenCGA.</p><p><em>Tags</em>: <em>internal</em></p>                                                                                                                                              |
| <p><strong>modificationDate</strong><br><em>String</em><br></p>                                                         | <p>String representing when was the last time the sample was modified, this is automatically set by OpenCGA.</p><p><em>Tags</em>: <em>internal</em></p>                                                                                                                           |
| <p><strong>lifeStatus</strong><br><em>LifeStatus</em><br></p>                                                           |                                                                                                                                                                                                                                                                                   |
| <p><strong>phenotypes</strong><br>List<<em>Phenotype</em>><br></p>                                                      | A List with related phenotypes.                                                                                                                                                                                                                                                   |
| <p><strong>disorders</strong><br>List<<em>Disorder</em>><br></p>                                                        | A List with related disorders.                                                                                                                                                                                                                                                    |
| <p><strong>samples</strong><br>List<<a href="#Sample"><em>Sample</em></a>><br></p>                                      | A List with related samples.                                                                                                                                                                                                                                                      |
| <p><strong>parentalConsanguinity</strong><br><em>boolean</em><br></p>                                                   |                                                                                                                                                                                                                                                                                   |
| <p><strong>status</strong><br><a href="#CustomStatus"><em>CustomStatus</em></a><br></p>                                 |                                                                                                                                                                                                                                                                                   |
| <p><strong>internal</strong><br><a href="#IndividualInternal"><em>IndividualInternal</em></a><br></p>                   |                                                                                                                                                                                                                                                                                   |
| <p><strong>attributes</strong><br>Map<<em>Object</em>,<em>String</em>><br></p>                                          | You can use this field to store any other information, keep in mind this is not indexed so you cannot search by attributes.                                                                                                                                                       |

### IndividualQualityControl

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/individual/IndividualQualityControl.java).

| Field                                                                                    | Description                                                                          |
| ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| <p><strong>inferredSexReports</strong><br>List<<em>InferredSexReport</em>><br></p>       | List of inferred sex reports, it depends on the method (currently by coverage ratio) |
| <p><strong>sampleRelatednessReport</strong><br><em>SampleRelatednessReport</em><br></p>  |                                                                                      |
| <p><strong>mendelianErrorReports</strong><br>List<<em>MendelianErrorReport</em>><br></p> | Mendelian errors                                                                     |
| <p><strong>fileIds</strong><br>List<<em>String</em>><br></p>                             | File IDs related to the quality control                                              |
| <p><strong>comments</strong><br>List<<em>ClinicalComment</em>><br></p>                   | Comments related to the quality control                                              |

### Sample

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/sample/Sample.java).

| Field                                                                                                                                  | Description                                                                                                                                                                                                                                                                                                         |
| -------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong>id</strong><br><em>String</em><br></p>                                                                                      | <p>Sample ID in the study, this must be unique in the study but can be repeated in different studies. This is a mandatory parameter<br>when creating a new sample, this ID cannot be changed at the moment.</p><p><em>Tags</em>: <em>required, immutable, unique</em></p>                                           |
| <p><strong>uuid</strong><br><em>String</em><br></p>                                                                                    | <p>Generic: Unique 32-character identifier assigned automatically by OpenCGA.</p><p><em>Tags</em>: <em>immutable, unique</em></p>                                                                                                                                                                                   |
| <p><strong>processing</strong><br><a href="#SampleProcessing"><em>SampleProcessing</em></a><br></p>                                    | Describes how the sample was processed in the lab.                                                                                                                                                                                                                                                                  |
| <p><strong>collection</strong><br><a href="#SampleCollection"><em>SampleCollection</em></a><br><br><em>since</em>: 2.1</p>             | <p>Describes how the sample was collected.</p><p><em>Note</em>: <em>The sample collection is a list of samples</em></p>                                                                                                                                                                                             |
| <p><strong>qualityControl</strong><br><a href="#SampleQualityControl"><em>SampleQualityControl</em></a><br><br><em>since</em>: 2.1</p> | <p>Contains different metrics to evaluate the quality of the sample.</p><p><em>Note</em>: <em>The sample collection is a list of samples</em><br><em>More info at</em>: <a href="https://www.zettagenomics.com">ZetaGenomics</a></p>                                                                                |
| <p><strong>release</strong><br><em>int</em><br></p>                                                                                    | <p>An integer describing the current data release.</p><p><em>Tags</em>: <em>immutable</em></p>                                                                                                                                                                                                                      |
| <p><strong>version</strong><br><em>int</em><br></p>                                                                                    | <p>Generic: Autoincremental version assigned to the registered entry. By default, updates does not create new versions. To enable<br>versioning, users must set the <code>incVersion</code> flag from the /update web service when updating the document.</p><p><em>Tags</em>: <em>immutable</em></p>               |
| <p><strong>creationDate</strong><br><em>String</em><br></p>                                                                            | <p>Generic: Autogenerated date following the format YYYYMMDDhhmmss containing the date when the entry was first registered.</p><p><em>Tags</em>: <em>immutable</em></p>                                                                                                                                             |
| <p><strong>modificationDate</strong><br><em>String</em><br></p>                                                                        | <p>Generic: Autogenerated date following the format YYYYMMDDhhmmss containing the date when the entry was last modified.</p><p><em>Tags</em>: <em>immutable</em></p>                                                                                                                                                |
| <p><strong>description</strong><br><em>String</em><br></p>                                                                             | Generic: Users may provide a description for the entry.                                                                                                                                                                                                                                                             |
| <p><strong>somatic</strong><br><em>boolean</em><br></p>                                                                                | Indicates if the sample is somatic or germline (default)                                                                                                                                                                                                                                                            |
| <p><strong>phenotypes</strong><br>List<<em>Phenotype</em>><br></p>                                                                     |                                                                                                                                                                                                                                                                                                                     |
| <p><strong>individualId</strong><br><em>String</em><br></p>                                                                            |                                                                                                                                                                                                                                                                                                                     |
| <p><strong>fileIds</strong><br>List<<em>String</em>><br></p>                                                                           |                                                                                                                                                                                                                                                                                                                     |
| <p><strong>cohortIds</strong><br>List<<em>String</em>><br></p>                                                                         |                                                                                                                                                                                                                                                                                                                     |
| <p><strong>status</strong><br><a href="#CustomStatus"><em>CustomStatus</em></a><br></p>                                                | Generic: Object to define the status of the entry.                                                                                                                                                                                                                                                                  |
| <p><strong>internal</strong><br><a href="#SampleInternal"><em>SampleInternal</em></a><br></p>                                          | <p>Generic: Field automatically managed by OpenCGA containing relevant information of the entry. This field is used for internal<br>purposes and is visible for users.</p><p><em>Tags</em>: <em>immutable</em></p>                                                                                                  |
| <p><strong>attributes</strong><br>Map<<em>Object</em>,<em>String</em>><br></p>                                                         | <p>Dictionary that can be customised by users to store any additional information users may require.</p><p><em>Note</em>: <em>This field is not meant to be queried. It should only contain extra information. To store additional information meant to</em><br><em>be queried, please use annotationSets.</em></p> |

### SampleCollection

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/sample/SampleCollection.java).

| Field                                                                          | Description |
| ------------------------------------------------------------------------------ | ----------- |
| <p><strong>tissue</strong><br><em>String</em><br></p>                          |             |
| <p><strong>organ</strong><br><em>String</em><br></p>                           |             |
| <p><strong>quantity</strong><br><em>String</em><br></p>                        |             |
| <p><strong>method</strong><br><em>String</em><br></p>                          |             |
| <p><strong>date</strong><br><em>String</em><br></p>                            |             |
| <p><strong>attributes</strong><br>Map<<em>Object</em>,<em>String</em>><br></p> |             |

### SampleQualityControl

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/sample/SampleQualityControl.java).

| Field                                                                                                                                | Description |
| ------------------------------------------------------------------------------------------------------------------------------------ | ----------- |
| <p><strong>fileIds</strong><br>List<<em>String</em>><br></p>                                                                         |             |
| <p><strong>comments</strong><br>List<<em>ClinicalComment</em>><br></p>                                                               |             |
| <p><strong>variant</strong><br><a href="#SampleVariantQualityControlMetrics"><em>SampleVariantQualityControlMetrics</em></a><br></p> |             |

### SampleVariantQualityControlMetrics

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/sample/SampleVariantQualityControlMetrics.java).

| Field                                                                           | Description |
| ------------------------------------------------------------------------------- | ----------- |
| <p><strong>variantStats</strong><br>List<<em>SampleQcVariantStats</em>><br></p> |             |
| <p><strong>signatures</strong><br>List<<em>Signature</em>><br></p>              |             |
| <p><strong>genomePlots</strong><br>List<<em>GenomePlot</em>><br></p>            |             |

### SampleProcessing

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/sample/SampleProcessing.java).

| Field                                                                          | Description |
| ------------------------------------------------------------------------------ | ----------- |
| <p><strong>product</strong><br><em>String</em><br></p>                         |             |
| <p><strong>preparationMethod</strong><br><em>String</em><br></p>               |             |
| <p><strong>extractionMethod</strong><br><em>String</em><br></p>                |             |
| <p><strong>labSampleId</strong><br><em>String</em><br></p>                     |             |
| <p><strong>quantity</strong><br><em>String</em><br></p>                        |             |
| <p><strong>date</strong><br><em>String</em><br></p>                            |             |
| <p><strong>attributes</strong><br>Map<<em>Object</em>,<em>String</em>><br></p> |             |

### SampleInternal

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/sample/SampleInternal.java).

| Field                                                                        | Description |
| ---------------------------------------------------------------------------- | ----------- |
| <p><strong>rga</strong><br><a href="#RgaIndex"><em>RgaIndex</em></a><br></p> |             |

### RgaIndex

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/common/RgaIndex.java).

| Field                                                                                             | Description                                                                                                                                                                                                                                    |
| ------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong>status</strong><br><a href="#enum-rgaindexstatus"><em>RgaIndex.Status</em></a><br></p> | <p>Nullam commodo tortor nec lectus cursus finibus. Sed quis orci fringilla, cursus diam quis, vehicula sapien. Etiam bibendum dapibus<br>lectus, ut ultrices nunc vulputate ac.</p><p><em>Tags</em>: <em>internal, unique, immutable</em></p> |
| <p><strong>date</strong><br><em>String</em><br></p>                                               | <p>Nullam commodo tortor nec lectus cursus finibus. Sed quis orci fringilla, cursus diam quis, vehicula sapien. Etiam bibendum dapibus<br>lectus, ut ultrices nunc vulputate ac.</p><p><em>Tags</em>: <em>internal, unique, immutable</em></p> |

### Enum RgaIndex.Status

*Enumeration class.* You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/common/RgaIndex/Status.java).

| Field                                            | Description |
| ------------------------------------------------ | ----------- |
| <p><strong>NOT\_INDEXED</strong><br></p>         |             |
| <p><strong>INDEXED</strong><br></p>              |             |
| <p><strong>INVALID\_PERMISSIONS</strong><br></p> |             |
| <p><strong>INVALID\_METADATA</strong><br></p>    |             |
| <p><strong>INVALID</strong><br></p>              |             |

### Location

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/individual/Location.java).

| Field                                                     | Description |
| --------------------------------------------------------- | ----------- |
| <p><strong>address</strong><br><em>String</em><br></p>    |             |
| <p><strong>postalCode</strong><br><em>String</em><br></p> |             |
| <p><strong>city</strong><br><em>String</em><br></p>       |             |
| <p><strong>state</strong><br><em>String</em><br></p>      |             |
| <p><strong>country</strong><br><em>String</em><br></p>    |             |

### IndividualPopulation

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/individual/IndividualPopulation.java).

| Field                                                        | Description |
| ------------------------------------------------------------ | ----------- |
| <p><strong>name</strong><br><em>String</em><br></p>          |             |
| <p><strong>subpopulation</strong><br><em>String</em><br></p> |             |
| <p><strong>description</strong><br><em>String</em><br></p>   |             |

### IndividualInternal

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/individual/IndividualInternal.java).

### FamilyInternal

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/family/FamilyInternal.java).

| Field                                                                                   | Description |
| --------------------------------------------------------------------------------------- | ----------- |
| <p><strong>status</strong><br><a href="#FamilyStatus"><em>FamilyStatus</em></a><br></p> |             |

### FamilyStatus

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/family/FamilyStatus.java).

| Field                                                             | Description |
| ----------------------------------------------------------------- | ----------- |
| <p><strong>INCOMPLETE</strong><br><em>String</em><br></p>         |             |
| <p><strong>STATUS\_LIST</strong><br>List<<em>String</em>><br></p> |             |

### ClinicalAnalysisQualityControl

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/clinical/ClinicalAnalysisQualityControl.java).

| Field                                                                                                                                                                        | Description |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| <p><strong>summary</strong><br><a href="#enum-clinicalanalysisqualitycontrolqualitycontrolsummary"><em>ClinicalAnalysisQualityControl.QualityControlSummary</em></a><br></p> |             |
| <p><strong>comments</strong><br>List<<em>ClinicalComment</em>><br></p>                                                                                                       |             |

### Enum ClinicalAnalysisQualityControl.QualityControlSummary

*Enumeration class.* You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/clinical/ClinicalAnalysisQualityControl/QualityControlSummary.java).

| Field                                     | Description |
| ----------------------------------------- | ----------- |
| <p><strong>HIGH</strong><br></p>          |             |
| <p><strong>MEDIUM</strong><br></p>        |             |
| <p><strong>LOW</strong><br></p>           |             |
| <p><strong>DISCARD</strong><br></p>       |             |
| <p><strong>NEEDS\_REVIEW</strong><br></p> |             |
| <p><strong>UNKNOWN</strong><br></p>       |             |

### Enum ClinicalAnalysis.Type

*Enumeration class.* You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/clinical/ClinicalAnalysis/Type.java).

| Field                                       | Description |
| ------------------------------------------- | ----------- |
| <p><strong>SINGLE</strong><br></p>          |             |
| <p><strong>FAMILY</strong><br></p>          |             |
| <p><strong>CANCER</strong><br></p>          |             |
| <p><strong>COHORT</strong><br></p>          |             |
| <p><strong>AUTOCOMPARATIVE</strong><br></p> |             |

### ClinicalConsentAnnotation

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/study/configuration/ClinicalConsentAnnotation.java).

| Field                                                                                                           | Description |
| --------------------------------------------------------------------------------------------------------------- | ----------- |
| <p><strong>consents</strong><br>List<<a href="#ClinicalConsentParam"><em>ClinicalConsentParam</em></a>><br></p> |             |
| <p><strong>date</strong><br><em>String</em><br></p>                                                             |             |

### ClinicalConsentParam

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/study/configuration/ClinicalConsentParam.java).

| Field                                                                                                                  | Description |
| ---------------------------------------------------------------------------------------------------------------------- | ----------- |
| <p><strong>id</strong><br><em>String</em><br></p>                                                                      |             |
| <p><strong>name</strong><br><em>String</em><br></p>                                                                    |             |
| <p><strong>description</strong><br><em>String</em><br></p>                                                             |             |
| <p><strong>value</strong><br><a href="#enum-clinicalconsentparamvalue"><em>ClinicalConsentParam.Value</em></a><br></p> |             |

### Enum ClinicalConsentParam.Value

*Enumeration class.* You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/study/configuration/ClinicalConsentParam/Value.java).

| Field                               | Description |
| ----------------------------------- | ----------- |
| <p><strong>YES</strong><br></p>     |             |
| <p><strong>NO</strong><br></p>      |             |
| <p><strong>UNKNOWN</strong><br></p> |             |

### FlagAnnotation

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/common/FlagAnnotation.java).

| Field                                                      | Description |
| ---------------------------------------------------------- | ----------- |
| <p><strong>id</strong><br><em>String</em><br></p>          |             |
| <p><strong>description</strong><br><em>String</em><br></p> |             |
| <p><strong>date</strong><br><em>String</em><br></p>        |             |

### ClinicalPriorityAnnotation

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/study/configuration/ClinicalPriorityAnnotation.java).

| Field                                                      | Description |
| ---------------------------------------------------------- | ----------- |
| <p><strong>id</strong><br><em>String</em><br></p>          |             |
| <p><strong>description</strong><br><em>String</em><br></p> |             |
| <p><strong>rank</strong><br><em>int</em><br></p>           |             |
| <p><strong>date</strong><br><em>String</em><br></p>        |             |

### Interpretation

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/clinical/Interpretation.java).

| Field                                                                                                         | Description |
| ------------------------------------------------------------------------------------------------------------- | ----------- |
| <p><strong>studyUid</strong><br><em>long</em><br></p>                                                         |             |
| <p><strong>uid</strong><br><em>long</em><br></p>                                                              |             |
| <p><strong>panels</strong><br>List<<a href="#Panel"><em>Panel</em></a>><br></p>                               |             |
| <p><strong>stats</strong><br><a href="#InterpretationStats"><em>InterpretationStats</em></a><br></p>          |             |
| <p><strong>internal</strong><br><a href="#InterpretationInternal"><em>InterpretationInternal</em></a><br></p> |             |
| <p><strong>release</strong><br><em>int</em><br></p>                                                           |             |

### InterpretationStats

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/clinical/InterpretationStats.java).

| Field                                                                                                                          | Description |
| ------------------------------------------------------------------------------------------------------------------------------ | ----------- |
| <p><strong>primaryFindings</strong><br><a href="#InterpretationFindingStats"><em>InterpretationFindingStats</em></a><br></p>   |             |
| <p><strong>secondaryFindings</strong><br><a href="#InterpretationFindingStats"><em>InterpretationFindingStats</em></a><br></p> |             |

### InterpretationFindingStats

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/clinical/InterpretationFindingStats.java).

| Field                                                                                                   | Description |
| ------------------------------------------------------------------------------------------------------- | ----------- |
| <p><strong>numVariants</strong><br><em>int</em><br></p>                                                 |             |
| <p><strong>tierCount</strong><br>Map<<em>Integer</em>,<em>String</em>><br></p>                          |             |
| <p><strong>variantStatusCount</strong><br>Map<<em>Integer</em>,<em>ClinicalVariant.Status</em>><br></p> |             |
| <p><strong>geneCount</strong><br>Map<<em>Integer</em>,<em>String</em>><br></p>                          |             |

### Panel

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/panel/Panel.java).

| Field                                                                       | Description                                                                   |
| --------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| <p><strong>uuid</strong><br><em>String</em><br></p>                         |                                                                               |
| <p><strong>release</strong><br><em>int</em><br></p>                         |                                                                               |
| <p><strong>version</strong><br><em>int</em><br></p>                         | OpenCGA version of this panel, this is incremented when the panel is updated. |
| <p><strong>author</strong><br><em>String</em><br></p>                       |                                                                               |
| <p><strong>status</strong><br><a href="#Status"><em>Status</em></a><br></p> |                                                                               |
| <p><strong>studyUid</strong><br><em>long</em><br></p>                       |                                                                               |
| <p><strong>uid</strong><br><em>long</em><br></p>                            |                                                                               |

### Status

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/common/Status.java).

| Field                                                             | Description                                                                                                                     |
| ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong>name</strong><br><em>String</em><br></p>               |                                                                                                                                 |
| <p><strong>date</strong><br><em>String</em><br></p>               |                                                                                                                                 |
| <p><strong>description</strong><br><em>String</em><br></p>        |                                                                                                                                 |
| <p><strong>message</strong><br><em>String</em><br></p>            |                                                                                                                                 |
| <p><strong>READY</strong><br><em>String</em><br></p>              | READY name means that the object is being used.                                                                                 |
| <p><strong>DELETED</strong><br><em>String</em><br></p>            | DELETED name means that the object is marked as removed, so it can be completely removed from the database with a clean action. |
| <p><strong>STATUS\_LIST</strong><br>List<<em>String</em>><br></p> |                                                                                                                                 |

### InterpretationInternal

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/clinical/InterpretationInternal.java).

| Field                                                                                                   | Description |
| ------------------------------------------------------------------------------------------------------- | ----------- |
| <p><strong>status</strong><br><a href="#InterpretationStatus"><em>InterpretationStatus</em></a><br></p> |             |

### InterpretationStatus

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/clinical/InterpretationStatus.java).

| Field                                                             | Description |
| ----------------------------------------------------------------- | ----------- |
| <p><strong>NOT\_REVIEWED</strong><br><em>String</em><br></p>      |             |
| <p><strong>UNDER\_REVIEW</strong><br><em>String</em><br></p>      |             |
| <p><strong>REVIEWED</strong><br><em>String</em><br></p>           |             |
| <p><strong>REJECTED</strong><br><em>String</em><br></p>           |             |
| <p><strong>STATUS\_LIST</strong><br>List<<em>String</em>><br></p> |             |

### ClinicalAnalysisInternal

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/clinical/ClinicalAnalysisInternal.java).

| Field                                                                                                       | Description |
| ----------------------------------------------------------------------------------------------------------- | ----------- |
| <p><strong>status</strong><br><a href="#ClinicalAnalysisStatus"><em>ClinicalAnalysisStatus</em></a><br></p> |             |

### ClinicalAnalysisStatus

You can find the Java code [here](https://github.com/opencb/opencga/blob/master/opencga-core/src/main/java/org/opencb/opencga/core/models/clinical/ClinicalAnalysisStatus.java).

| Field                                                                               | Description |
| ----------------------------------------------------------------------------------- | ----------- |
| <p><strong>INCOMPLETE</strong><br><em>String</em><br></p>                           |             |
| <p><strong>READY\_FOR\_VALIDATION</strong><br><em>String</em><br></p>               |             |
| <p><strong>READY\_FOR\_INTERPRETATION</strong><br><em>String</em><br></p>           |             |
| <p><strong>INTERPRETATION\_IN\_PROGRESS</strong><br><em>String</em><br></p>         |             |
| <p><strong>READY\_FOR\_INTEPRETATION\_REVIEW</strong><br><em>String</em><br></p>    |             |
| <p><strong>INTERPRETATION\_REVIEW\_IN\_PROGRESS</strong><br><em>String</em><br></p> |             |
| <p><strong>READY\_FOR\_REPORT</strong><br><em>String</em><br></p>                   |             |
| <p><strong>REPORT\_IN\_PROGRESS</strong><br><em>String</em><br></p>                 |             |
| <p><strong>DONE</strong><br><em>String</em><br></p>                                 |             |
| <p><strong>REVIEW\_IN\_PROGRESS</strong><br><em>String</em><br></p>                 |             |
| <p><strong>CLOSED</strong><br><em>String</em><br></p>                               |             |
| <p><strong>REJECTED</strong><br><em>String</em><br></p>                             |             |
| <p><strong>STATUS\_LIST</strong><br>List<<em>String</em>><br></p>                   |             |
