From 4befffc49c2b10aa75dcf394b1c29ea040d67c9b Mon Sep 17 00:00:00 2001
From: Brian Raymor <brianraymor@chanzuckerberg.com>
Date: Mon, 2 Dec 2024 15:43:12 -0800
Subject: [PATCH] updated genetic ancestry values (#1141)

---
 schema/drafts/5.3.0.md | 32 +++++++++++++-------------------
 1 file changed, 13 insertions(+), 19 deletions(-)

diff --git a/schema/drafts/5.3.0.md b/schema/drafts/5.3.0.md
index a65f74a8..ba1cd0ab 100644
--- a/schema/drafts/5.3.0.md
+++ b/schema/drafts/5.3.0.md
@@ -583,10 +583,9 @@ If <code>organism_ontolology_term_id</code> is <code>"NCBITaxon:9606"</code> for
     <tr>
       <th>Value</th>
       <td>
-        <code>str</code> or <code>float</code>. All observations with the same <code>donor_id</code> MUST contain the same value.<br><br>
+        <code>float</code>. All observations with the same <code>donor_id</code> MUST contain the same value.<br><br>
         If <code>organism_ontolology_term_id</code> is NOT
-        <code>"NCBITaxon:9606"</code> for <i>Homo sapiens</i>, then the
-        value MUST be <code>"na"</code>.<br><br>If
+        <code>"NCBITaxon:9606"</code> for <i>Homo sapiens</i>, then the value MUST be a <code>float("nan")</code>.<br><br>If
         <code>organism_ontolology_term_id</code> is
         <code>"NCBITaxon:9606"</code> for <i>Homo sapiens</i>, then the value MUST be a <code>float("nan")</code> if unavailable; otherwise, the value MUST be the genetic ancestry percentage of <a href="https://www.ebi.ac.uk/ols4/ontologies/hancestro/classes/http%253A%252F%252Fpurl.obolibrary.org%252Fobo%252FHANCESTRO_0010"><code>"HANCESTRO:0010"</code></a> for <i>African</i> expressed as a <code>float</code> greater than or equal to <code>0.0</code> and less than or equal to <code>1.0</code>
       </td>
@@ -610,10 +609,9 @@ If <code>organism_ontolology_term_id</code> is <code>"NCBITaxon:9606"</code> for
     <tr>
       <th>Value</th>
       <td>
-        <code>str</code> or <code>float</code>. All observations with the same <code>donor_id</code> MUST contain the same value.<br><br>
-        If <code>organism_ontolology_term_id</code> is NOT
-        <code>"NCBITaxon:9606"</code> for <i>Homo sapiens</i>, then the
-        value MUST be <code>"na"</code>.<br><br>If
+        <code>float</code>. All observations with the same <code>donor_id</code> MUST contain the same value.<br><br>
+                If <code>organism_ontolology_term_id</code> is NOT
+        <code>"NCBITaxon:9606"</code> for <i>Homo sapiens</i>, then the value MUST be a <code>float("nan")</code>.<br><br>If
         <code>organism_ontolology_term_id</code> is
         <code>"NCBITaxon:9606"</code> for <i>Homo sapiens</i>, then the value MUST be a <code>float("nan")</code> if unavailable; otherwise, the value MUST be the genetic ancestry percentage of <a href="https://www.ebi.ac.uk/ols4/ontologies/hancestro/classes/http%253A%252F%252Fpurl.obolibrary.org%252Fobo%252FHANCESTRO_0009"><code>"HANCESTRO:0009"</code></a> for <i>East Asian</i> expressed as a <code>float</code> greater than or equal to <code>0.0</code> and less than or equal to <code>1.0</code>
       </td>
@@ -637,10 +635,9 @@ If <code>organism_ontolology_term_id</code> is <code>"NCBITaxon:9606"</code> for
     <tr>
       <th>Value</th>
       <td>
-        <code>str</code> or <code>float</code>. All observations with the same <code>donor_id</code> MUST contain the same value.<br><br>
+        <code>float</code>. All observations with the same <code>donor_id</code> MUST contain the same value.<br><br>
         If <code>organism_ontolology_term_id</code> is NOT
-        <code>"NCBITaxon:9606"</code> for <i>Homo sapiens</i>, then the
-        value MUST be <code>"na"</code>.<br><br>If
+        <code>"NCBITaxon:9606"</code> for <i>Homo sapiens</i>, then the value MUST be a <code>float("nan")</code>.<br><br>If
         <code>organism_ontolology_term_id</code> is
         <code>"NCBITaxon:9606"</code> for <i>Homo sapiens</i>, then the value MUST be a <code>float("nan")</code> if unavailable; otherwise, the value MUST be the genetic ancestry percentage of <a href="https://www.ebi.ac.uk/ols4/ontologies/hancestro/classes/http%253A%252F%252Fpurl.obolibrary.org%252Fobo%252FHANCESTRO_0005"><code>"HANCESTRO:0005"</code></a> for <i>European</i> expressed as a <code>float</code> greater than or equal to <code>0.0</code> and less than or equal to <code>1.0</code>
       </td>
@@ -664,10 +661,9 @@ If <code>organism_ontolology_term_id</code> is <code>"NCBITaxon:9606"</code> for
     <tr>
       <th>Value</th>
       <td>
-        <code>str</code> or <code>float</code>. All observations with the same <code>donor_id</code> MUST contain the same value.<br><br>
+        <code>float</code>. All observations with the same <code>donor_id</code> MUST contain the same value.<br><br>
         If <code>organism_ontolology_term_id</code> is NOT
-        <code>"NCBITaxon:9606"</code> for <i>Homo sapiens</i>, then the
-        value MUST be <code>"na"</code>.<br><br>If
+        <code>"NCBITaxon:9606"</code> for <i>Homo sapiens</i>, then the value MUST be a <code>float("nan")</code>.<br><br>If
         <code>organism_ontolology_term_id</code> is
         <code>"NCBITaxon:9606"</code> for <i>Homo sapiens</i>, then the value MUST be a <code>float("nan")</code> if unavailable; otherwise, the value MUST be the genetic ancestry percentage of <a href="https://www.ebi.ac.uk/ols4/ontologies/hancestro/classes/http%253A%252F%252Fpurl.obolibrary.org%252Fobo%252FHANCESTRO_0013"><code>"HANCESTRO:0013"</code></a> for <i>Indigenous American</i> expressed as a <code>float</code> greater than or equal to <code>0.0</code> and less than or equal to <code>1.0</code>
       </td>
@@ -691,10 +687,9 @@ If <code>organism_ontolology_term_id</code> is <code>"NCBITaxon:9606"</code> for
     <tr>
       <th>Value</th>
       <td>
-        <code>str</code> or <code>float</code>. All observations with the same <code>donor_id</code> MUST contain the same value.<br><br>
+        <code>float</code>. All observations with the same <code>donor_id</code> MUST contain the same value.<br><br>
         If <code>organism_ontolology_term_id</code> is NOT
-        <code>"NCBITaxon:9606"</code> for <i>Homo sapiens</i>, then the
-        value MUST be <code>"na"</code>.<br><br>If
+        <code>"NCBITaxon:9606"</code> for <i>Homo sapiens</i>, then the value MUST be a <code>float("nan")</code>.<br><br>If
         <code>organism_ontolology_term_id</code> is
         <code>"NCBITaxon:9606"</code> for <i>Homo sapiens</i>, then the value MUST be a <code>float("nan")</code> if unavailable; otherwise, the value MUST be the genetic ancestry percentage of <a href="https://www.ebi.ac.uk/ols4/ontologies/hancestro/classes/http%253A%252F%252Fpurl.obolibrary.org%252Fobo%252FHANCESTRO_0017"><code>"HANCESTRO:0017"</code></a> for <i>Oceanian</i> expressed as a <code>float</code> greater than or equal to <code>0.0</code> and less than or equal to <code>1.0</code>
       </td>
@@ -718,10 +713,9 @@ If <code>organism_ontolology_term_id</code> is <code>"NCBITaxon:9606"</code> for
     <tr>
       <th>Value</th>
       <td>
-        <code>str</code> or <code>float</code>. All observations with the same <code>donor_id</code> MUST contain the same value.<br><br>
+        <code>float</code>. All observations with the same <code>donor_id</code> MUST contain the same value.<br><br>
         If <code>organism_ontolology_term_id</code> is NOT
-        <code>"NCBITaxon:9606"</code> for <i>Homo sapiens</i>, then the
-        value MUST be <code>"na"</code>.<br><br>If
+        <code>"NCBITaxon:9606"</code> for <i>Homo sapiens</i>, then the value MUST be a <code>float("nan")</code>.<br><br>If
         <code>organism_ontolology_term_id</code> is
         <code>"NCBITaxon:9606"</code> for <i>Homo sapiens</i>, then the value MUST be a <code>float("nan")</code> if unavailable; otherwise, the value MUST be the genetic ancestry percentage of <a href="https://www.ebi.ac.uk/ols4/ontologies/hancestro/classes/http%253A%252F%252Fpurl.obolibrary.org%252Fobo%252FHANCESTRO_0006"><code>"HANCESTRO:0006"</code></a> for <i>South Asian</i> expressed as a <code>float</code> greater than or equal to <code>0.0</code> and less than or equal to <code>1.0</code>
       </td>