Phenotypic Data =============== The phenotypic module facilitates the collection of structured clinical data using standard ontologies such as the Human Phenotype Ontology (HPO_), the Orphanet Rare Disease Ontology (ORDO_) and Online Mendelian Inheritance in Man (OMIM_). Below we explain how to submit a new index case, and how to add new family members to the pedigree chart. If you have any questions, please contact our helpedesk via help@rd-connect.eu .. _access: - Access https://platform.rd-connect.eu/phenostore .. image:: ../img/screens/home.png **Left side-bar (1)** - Side-bar fixed in all phenotypic submission steps - provides direct access to different phenotype submission steps. **Bottom menus (2)** - Menus containing access to different ways to introduce participants, and to browse your submitted cases. Submission of phenotypic data ----------------------------- There are different ways to enter phenotypic information in the system: 1. Manual form submission (case by case approach recommended when phenotypic data is not structured using HPO/OMIM/ORDO) 2. Bulk import using an excel template (recommended when the data is already HPO/OMIM/ORDO encoded) 3. Bulk import via transfer from a PhenoTips instance Form Submission ^^^^^^^^^^^^^^^ The system provides a user friendly interface and several disease templates to facilitate structured phenotypic data entry using HPO, ORDO and OMIM. **New cases /families must be created by starting from the index case.** In the **Phenotypic Data Submission Site** enter the **New Index Case** section in the bottom menu. Press the **Create a new case** button. .. image:: ../img/screens/case_flow_logo.png Choose a template which will provide you with specific disease fields relevant to your index case, or choose the **Default template** for a general form. .. Figure:: ../img/screens/templates.png - Follow the different steps to enter the patient's phenotypic information. Note that structured vocabulary is used to capture the data and that several fields in the Individual Information section are mandatory. Once finalised press the “submit button” to create the index case entry .. image:: ../img/screens/steps.jpg .. important:: To create an index case, the following fields are required: * Year of birth * Affected Status * Status of case (solved/unsolved) * In the case of a *solved status*, we ask that the **final diagnosis** is provided .. Figure:: ../img/screens/hpo_view.png HPO terms can be searched for in the HPO ontology using the search bar. Also, the HPO tree can be navigated in a dedicated section. When a template is selected, the HPO terms configured for that template are automatically loaded in the tree. :Note: **We strongly encourage** the selection of 5+ HPO terms to describe a case's symptoms (6-symptoms section) and to enter the suspected or confirmed clinical diagnosis (8-diagnosis), in order to facilitate downstream phenotypic and genomic analysis, as this information is fully integrated in the GPAP (cohort creation, gene filtering, variant prioritisation, patient matchmaking, etc.). If you are in possession of this information, for each HPO term it is possible to indicate the level of severity with a slider that ranges from MILD to PROFOUND severity (HPO Classification for severity term HP:0012824). Once submitted, a message confirming the creation of the index case will appear with different options to continue: “add a relative” (to add additional family members in the pedigree), “see my cases (to browse all your data) or “see summary (to access a downloadable summary of the submitted participant). .. image:: ../img/screens/screen_submission.jpg :height: 300px :align: center Bulk Import ^^^^^^^^^^^ To perform a bulk import of phenotypic data, enter the **Import Cases** section in the bottom menu of the **Phenotypic Data Submission Module**. **Excel file:** Download the provided template, complete all the necessary fields, and use the **Upload a Local File** button to upload it. Please note that several fields are mandatory. Finally press *Import* to complete the submission. .. image:: ../img/screens/bulk_upload.png :height: 300px :width: 400 px Edit Index Case Pedigree ^^^^^^^^^^^^^^^^^^^^^^^^ :Note: A pedigree is editable *only* after the creation of an index case with the mandatory information. You can enter a Pedigree (and export an image of it) by accessing any record and clicking on the **Pedigree** button. .. figure:: ../img/screens/access_ped.jpg :scale: 70 % :align: center The pedigree editor will enable you to: 1. Export the pedigree in JSON or PED format 2. Import a new pedigree from a PED file 3. Access detailed instructions to modify a pedigree 4. Manually modify the current pedigree .. figure:: ../img/screens/options_ped.jpg :scale: 80 % :align: center .. figure:: ../img/screens/options_ped_1.jpg :scale: 80 % :align: center For detailed instructions, please refer to the image below. This can be also found by clicking on the detailed instructions (3). .. figure:: ../img/screens/pedigree_instructions.png :scale: 80 % :align: center Add a member to a pedigree ^^^^^^^^^^^^^^^^^^^^^^^^^^ In the *Phenotypic Data Submission Site* enter the *New Family member* item in the sidebar (or from the homepage). .. figure:: ../img/screens/family_member.jpg :scale: 80 % Select the Index Case ID of the family for which you want to create a new member and click on *Go to participant form*. In the Index Case form access the Pedigree section: .. figure:: ../img/screens/new_member_dialog.png :scale: 60 % The user is redirected to the the Index Case form. Here, you can click on the **Pedigree** tab to edit the Family. .. figure:: ../img/screens/update_form.png :scale: 60 % Use the Pedigree tools to add the new family member to the pedigree. Specific instructions on how to add nodes, and further information in the pedigree can be accessed by clicking on “Read the instruction” at the top right of the page. For more information, see section below: Edit Index Case Pedigree. Assign Participant Permissions ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ By clicking the Permissions button in the Patient form page, you can share/unshare your participant's record with other GPAP groups: - Access the participant’s record and push the “Edit” button - Access the “Permissions” button at the top-right side. .. image:: ../img/screens/permissions.jpg A new menu will appear showing the current owner, and a dropdown to add other groups as “Collaborators”. Add in this dropdown the groups that could have access to this record. .. image:: ../img/screens/dialog_owner.png External Resources ^^^^^^^^^^^^^^^^^^ We rely on a set of external resources to facilitate participant data submission in a standard format. - *The Orphanet Rare Disease ontology (ORDO)*: https://orpha.net - *Online Mendelian Inheritance in Man (OMIM)* : https://api.omim.org/ - *The Human Phenotype Ontology (HPO)* : https://hpo.jax.org/ - *Gene Search (HUGO Gene Nomenclature Committee):* https://www.genenames.org Management of phenotypic data ----------------------------- Browse GPAP PhenoStore Cases ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - In the “Phenotypic Data Submission Site” enter the “Browse your cases” section in the bottom menu, - This section shows a summary of all your submitted data and data shared with you, - At the top you will find statistics of your submitted/shared participants. You can also filter entries by selecting a specific time range of interest. Please, note that this filter also applies to the export .. image:: ../img/screens/filter_by_dates.png - At the bottom you have a table of your participants. A toolbar allows you to customize the columns of the table, to export records in CSV or PhenoPackets. You can directly access their records by clicking on their *ID* codes, and export all your data in .tsv format by using the “Export to TSV” button. .. image:: ../img/screens/table.png Export GPAP Phenostore Cases ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ From the “browse cases section”, a list of cases can be exported by clicking on the "Export Data" button. The downloaded file will include the list of participants currently displayed in the participant table. The fields included are the following: - GPAP Local ID - Family ID - Index Case (yes or no) - Affected Status (Affected or Unaffected) - Solved Status (Solved or Unsolved) - Sex (M, F or U) - Consanguinity (Yes or No) - ORDO - OMIM You can also download Phenopackets from the participants displayed in the participant table by using the "Export to Phenopackets" button. In addition, individual phenotypic information can be exported in Phenopacket and pdf formats by accessing each individual participant form.