New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[issue/273] Add documentation on delimiters being replaced #306
base: master
Are you sure you want to change the base?
Conversation
akotlar
commented
Oct 19, 2023
- Add documentation on delimiters being replaced by "," at build time.
FIELDS.md
Outdated
@@ -6,16 +6,14 @@ | |||
### General output information: | |||
<p style="margin-left: 40px"> Missing data in the annotation is marked by <strong>'!'</strong> </p> | |||
<p style="margin-left: 40px"> Multiple values for a single annotated position are separated by <strong>';'</strong> </p> | |||
<p style="margin-left: 40px"> Multiple values for a single annotated position that are nested within <strong>';'</strong> delimited values (e.g 2D values) are separated by <strong>ASCII UNIT SEPARATOR (ASCII code 31)</strong> </p> |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
it might help to give a small example of when such a structure might occur, and what the data would look like in that case
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Good suggestion, will take care of that in the morning.
FIELDS.md
Outdated
- When multiple dbSNP rows overlap, we store each field at that position in a 1D array, which loses the relationship between dbSNP.alleles and dbSNP.name | ||
Reserved characters for use as delimiters | ||
- ";" "|", ASCII UNIT SEPARATOR (ASCII character 31) | ||
- "/" will replace the ASCII UNIT SEPARATOR character 31 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
these lines might be clearer with additional language like: "currently... in a future release..."
FIELDS.md
Outdated
Reserved characters for use as delimiters | ||
- ";" "|", ASCII UNIT SEPARATOR (ASCII character 31) | ||
- "/" will replace the ASCII UNIT SEPARATOR character 31 | ||
- Any instances os these chracters in values to be inserted into the database at build time, will be replaced at build time with a "," |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"of these characters"
- When multiple dbSNP rows overlap, we store each field at that position in a 1D array, which loses the relationship between dbSNP.alleles and dbSNP.name | ||
<br/> | ||
|
||
- Missing data in the annotation is marked by **`!`** |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Update how missing data is marked 'NA'/nan.