# Clinical Description Annotator


Annotator for annotating measurement results, workflows, workflow tools, models, and workflow tool process datasets in
SPARC SDS datasets to the data format required for digitaltwins-on-fhir.
## Usage
## Annotator measurements for SPARC SDS dataset
- Add measurement for one patient
```py
from fhir_cda import Annotator
from fhir_cda.ehr import Measurement, ObservationValue, Quantity
annotator = Annotator("./dataset/dataset-sparc").measurements()
m = Measurement(
value=ObservationValue(
value_quantity=Quantity(
value=30,
unit="year",
code="a")),
code="30525-0")
annotator.add_measurements("sub-001", m).save()
```
- Add measurements for one patient
```py
m1 = Measurement(
value=ObservationValue(
value_quantity=Quantity(
value=0.15,
unit="cm",
code="cm")),
code="21889-1")
m2 = Measurement(
value=ObservationValue(
value_quantity=Quantity(
value=0.15,
unit="cm",
code="cm",
system="http://unitsofmeasure.org")),
code="21889-1",
code_system="http://loinc.org",
display="Size Tumor")
annotator.add_measurements("sub-001", [m1, m2]).save()
```
- Add measurement for multiple patients
```py
m = Measurement(
value=ObservationValue(value_string="Female"),
code="99502-7",
display="Recorded sex or gender",
code_system="http://loinc.org")
annotator.add_measurements(["sub-001", "sub-002"], m).save()
```
- A measurements for multiple patients
```py
m1 = Measurement(
value=ObservationValue(value_string="Female"),
code="99502-7",
display="Recorded sex or gender",
code_system="http://loinc.org")
m2 = Measurement(
value=ObservationValue(
value_quantity=Quantity(
value=0.15,
unit="cm",
code="cm",
system="http://unitsofmeasure.org")),
code="21889-1",
code_system="http://loinc.org",
display="Size Tumor")
annotator.add_measurements(["sub-001", "sub-002"], [m1, m2])
annotator.save()
```
- Notice: The default value for `unit system` and `code system` are:
```python
unit_system = "http://unitsofmeasure.org"
code_system = "http://loinc.org"
```
Raw data
{
"_id": null,
"home_page": null,
"name": "fhir-cda",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "fhir, SPARC, Clinic Description Annotator",
"author": null,
"author_email": "Linkun Gao <gaolinkun123@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/6b/b9/c35b6ba504d38e94a300a28fb16075fb5d02489da8e8b3628e25fb89f54b/fhir_cda-1.0.6.tar.gz",
"platform": null,
"description": "# Clinical Description Annotator\n\n\n\n\nAnnotator for annotating measurement results, workflows, workflow tools, models, and workflow tool process datasets in\nSPARC SDS datasets to the data format required for digitaltwins-on-fhir.\n\n## Usage\n\n## Annotator measurements for SPARC SDS dataset\n\n- Add measurement for one patient\n\n```py\nfrom fhir_cda import Annotator\nfrom fhir_cda.ehr import Measurement, ObservationValue, Quantity\n\nannotator = Annotator(\"./dataset/dataset-sparc\").measurements()\n\nm = Measurement(\n value=ObservationValue(\n value_quantity=Quantity(\n value=30,\n unit=\"year\",\n code=\"a\")),\n code=\"30525-0\")\n\nannotator.add_measurements(\"sub-001\", m).save()\n```\n\n- Add measurements for one patient\n\n```py\nm1 = Measurement(\n value=ObservationValue(\n value_quantity=Quantity(\n value=0.15,\n unit=\"cm\",\n code=\"cm\")),\n code=\"21889-1\")\nm2 = Measurement(\n value=ObservationValue(\n value_quantity=Quantity(\n value=0.15,\n unit=\"cm\",\n code=\"cm\",\n system=\"http://unitsofmeasure.org\")),\n code=\"21889-1\",\n code_system=\"http://loinc.org\",\n display=\"Size Tumor\")\nannotator.add_measurements(\"sub-001\", [m1, m2]).save()\n```\n\n- Add measurement for multiple patients\n\n```py\nm = Measurement(\n value=ObservationValue(value_string=\"Female\"),\n code=\"99502-7\",\n display=\"Recorded sex or gender\",\n code_system=\"http://loinc.org\")\nannotator.add_measurements([\"sub-001\", \"sub-002\"], m).save()\n```\n\n- A measurements for multiple patients\n\n```py\nm1 = Measurement(\n value=ObservationValue(value_string=\"Female\"),\n code=\"99502-7\",\n display=\"Recorded sex or gender\",\n code_system=\"http://loinc.org\")\nm2 = Measurement(\n value=ObservationValue(\n value_quantity=Quantity(\n value=0.15,\n unit=\"cm\",\n code=\"cm\",\n system=\"http://unitsofmeasure.org\")),\n code=\"21889-1\",\n code_system=\"http://loinc.org\",\n display=\"Size Tumor\")\nannotator.add_measurements([\"sub-001\", \"sub-002\"], [m1, m2])\nannotator.save()\n```\n\n- Notice: The default value for `unit system` and `code system` are:\n\n```python\nunit_system = \"http://unitsofmeasure.org\"\ncode_system = \"http://loinc.org\"\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "Clinic Description Annotator for FHIR and SPARC",
"version": "1.0.6",
"project_urls": {
"Documentation": "https://github.com/ABI-CTT-Group/clinical-description-annotator#readme",
"Homepage": "https://github.com/ABI-CTT-Group/clinical-description-annotator",
"Source": "https://github.com/ABI-CTT-Group/clinical-description-annotator.git"
},
"split_keywords": [
"fhir",
" sparc",
" clinic description annotator"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e97c6358042db499658f89fa70c2e30f4f7db8b001c4b739dfa997557e75fe69",
"md5": "fb3930eb2031497a213f5bf2428b0460",
"sha256": "51340253dd50a5d4f0150bcc9bbb76de2ff935c9c53f7dcf0ad8278eb19f49b0"
},
"downloads": -1,
"filename": "fhir_cda-1.0.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fb3930eb2031497a213f5bf2428b0460",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 13085,
"upload_time": "2024-08-28T21:45:28",
"upload_time_iso_8601": "2024-08-28T21:45:28.757270Z",
"url": "https://files.pythonhosted.org/packages/e9/7c/6358042db499658f89fa70c2e30f4f7db8b001c4b739dfa997557e75fe69/fhir_cda-1.0.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6bb9c35b6ba504d38e94a300a28fb16075fb5d02489da8e8b3628e25fb89f54b",
"md5": "91bf6f91a5f067882dfabcce34983648",
"sha256": "d54f63ed1465e0fc09e9e745d192c8afc820b79814c307f5b8d9025840cb742f"
},
"downloads": -1,
"filename": "fhir_cda-1.0.6.tar.gz",
"has_sig": false,
"md5_digest": "91bf6f91a5f067882dfabcce34983648",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 11116,
"upload_time": "2024-08-28T21:45:30",
"upload_time_iso_8601": "2024-08-28T21:45:30.199080Z",
"url": "https://files.pythonhosted.org/packages/6b/b9/c35b6ba504d38e94a300a28fb16075fb5d02489da8e8b3628e25fb89f54b/fhir_cda-1.0.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-28 21:45:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ABI-CTT-Group",
"github_project": "clinical-description-annotator#readme",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "fhir-cda"
}