Sentence Entity Resolver for SNOMED CT (Body Structures) (mpnet_embeddings_biolord_2023_c embeddings)

Description

This model maps extracted clinical NER entities to SNOMED CT concepts using mpnet_embeddings_biolord_2023_c embeddings.

It is trained on SNOMED CT US Edition 20260901 release.

Live Demo Open in Colab Copy S3 URI

How to use

documentAssembler = DocumentAssembler()\
    .setInputCol("text")\
    .setOutputCol("document")

sentenceDetectorDL = SentenceDetectorDLModel.pretrained("sentence_detector_dl_healthcare", "en", "clinical/models")\
    .setInputCols(["document"])\
    .setOutputCol("sentence")

tokenizer = Tokenizer()\
    .setInputCols(["sentence"])\
    .setOutputCol("token")

word_embeddings = WordEmbeddingsModel.pretrained("embeddings_clinical","en","clinical/models")\
    .setInputCols(["sentence","token"])\
    .setOutputCol("embeddings")

ner_jsl = MedicalNerModel.pretrained("ner_jsl","en","clinical/models")\
    .setInputCols(["sentence","token","embeddings"])\
    .setOutputCol("ner_jsl_tags")

ner_jsl_converter = NerConverterInternal()\
    .setInputCols(["sentence","token","ner_jsl_tags"])\
    .setOutputCol("ner_chunk_jsl")\
    .setWhiteList(["Disease_Syndrome_Disorder", "External_body_part_or_region"])\
    .setReplaceLabels({"Disease_Syndrome_Disorder": "BodyPart", "External_body_part_or_region": "BodyPart"})

ner_anatomy = MedicalNerModel.pretrained("ner_anatomy_coarse","en","clinical/models")\
    .setInputCols(["sentence","token","embeddings"])\
    .setOutputCol("ner_anatomy_tags")

ner_anatomy_converter = NerConverterInternal()\
    .setInputCols(["sentence","token","ner_anatomy_tags"])\
    .setOutputCol("ner_chunk_anatomy")\
    .setReplaceLabels({"Anatomy": "BodyPart"})

ner_oncology_anatomy = MedicalNerModel.pretrained("ner_oncology_anatomy_general","en","clinical/models")\
    .setInputCols(["sentence","token","embeddings"])\
    .setOutputCol("ner_oncology_anatomy_tags")

ner_oncology_anatomy_converter = NerConverterInternal()\
    .setInputCols(["sentence","token","ner_oncology_anatomy_tags"])\
    .setOutputCol("ner_chunk_oncology_anatomy")\
    .setReplaceLabels({"Anatomical_Site": "BodyPart"})

chunk_merger = ChunkMergeApproach()\
    .setInputCols(["ner_chunk_jsl", "ner_chunk_anatomy", "ner_chunk_oncology_anatomy"])\
    .setOutputCol("ner_chunk")

chunk2doc = Chunk2Doc()\
    .setInputCols(["ner_chunk"])\
    .setOutputCol("ner_chunk_doc")

embedder = MPNetEmbeddings.pretrained("mpnet_embeddings_biolord_2023_c", "en")\
    .setInputCols(["ner_chunk_doc"])\
    .setOutputCol("resolver_embeddings")\
    .setCaseSensitive(False)\
    .setBatchSize(1)

resolver = SentenceEntityResolverModel.pretrained("biolordresolve_snomed_bodyStructure_20260901","en","clinical/models")\
    .setInputCols(["resolver_embeddings"])\
    .setOutputCol("snomed_code")\
    .setDistanceFunction("EUCLIDEAN")\
    .setThreshold(1000)

pipeline = Pipeline(stages=[\
    documentAssembler, sentenceDetectorDL, tokenizer, word_embeddings, ner_jsl, ner_jsl_converter, ner_anatomy, ner_anatomy_converter, ner_oncology_anatomy, ner_oncology_anatomy_converter, chunk_merger, chunk2doc, embedder, resolver\
])

data = spark.createDataFrame([["The patient is a 30-year-old female with coronary artery disease and swelling affecting the kidney and lower limb."]]).toDF("text")
result = pipeline.fit(data).transform(data)
documentAssembler = nlp.DocumentAssembler()\
    .setInputCol("text")\
    .setOutputCol("document")

sentenceDetectorDL = nlp.SentenceDetectorDLModel.pretrained("sentence_detector_dl_healthcare", "en", "clinical/models")\
    .setInputCols(["document"])\
    .setOutputCol("sentence")

tokenizer = nlp.Tokenizer()\
    .setInputCols(["sentence"])\
    .setOutputCol("token")

word_embeddings = nlp.WordEmbeddingsModel.pretrained("embeddings_clinical","en","clinical/models")\
    .setInputCols(["sentence","token"])\
    .setOutputCol("embeddings")

ner_jsl = medical.NerModel.pretrained("ner_jsl","en","clinical/models")\
    .setInputCols(["sentence","token","embeddings"])\
    .setOutputCol("ner_jsl_tags")

ner_jsl_converter = medical.NerConverterInternal()\
    .setInputCols(["sentence","token","ner_jsl_tags"])\
    .setOutputCol("ner_chunk_jsl")\
    .setWhiteList(["Disease_Syndrome_Disorder", "External_body_part_or_region"])\
    .setReplaceLabels({"Disease_Syndrome_Disorder": "BodyPart", "External_body_part_or_region": "BodyPart"})

ner_anatomy = medical.NerModel.pretrained("ner_anatomy_coarse","en","clinical/models")\
    .setInputCols(["sentence","token","embeddings"])\
    .setOutputCol("ner_anatomy_tags")

ner_anatomy_converter = medical.NerConverterInternal()\
    .setInputCols(["sentence","token","ner_anatomy_tags"])\
    .setOutputCol("ner_chunk_anatomy")\
    .setReplaceLabels({"Anatomy": "BodyPart"})

ner_oncology_anatomy = medical.NerModel.pretrained("ner_oncology_anatomy_general","en","clinical/models")\
    .setInputCols(["sentence","token","embeddings"])\
    .setOutputCol("ner_oncology_anatomy_tags")

ner_oncology_anatomy_converter = medical.NerConverterInternal()\
    .setInputCols(["sentence","token","ner_oncology_anatomy_tags"])\
    .setOutputCol("ner_chunk_oncology_anatomy")\
    .setReplaceLabels({"Anatomical_Site": "BodyPart"})

chunk_merger = medical.ChunkMergeApproach()\
    .setInputCols(["ner_chunk_jsl", "ner_chunk_anatomy", "ner_chunk_oncology_anatomy"])\
    .setOutputCol("ner_chunk")

chunk2doc = nlp.Chunk2Doc()\
    .setInputCols(["ner_chunk"])\
    .setOutputCol("ner_chunk_doc")

embedder = nlp.MPNetEmbeddings.pretrained("mpnet_embeddings_biolord_2023_c", "en")\
    .setInputCols(["ner_chunk_doc"])\
    .setOutputCol("resolver_embeddings")\
    .setCaseSensitive(False)\
    .setBatchSize(1)

resolver = medical.SentenceEntityResolverModel.pretrained("biolordresolve_snomed_bodyStructure_20260901","en","clinical/models")\
    .setInputCols(["resolver_embeddings"])\
    .setOutputCol("snomed_code")\
    .setDistanceFunction("EUCLIDEAN")\
    .setThreshold(1000)

pipeline = nlp.Pipeline(stages=[\
    documentAssembler, sentenceDetectorDL, tokenizer, word_embeddings, ner_jsl, ner_jsl_converter, ner_anatomy, ner_anatomy_converter, ner_oncology_anatomy, ner_oncology_anatomy_converter, chunk_merger, chunk2doc, embedder, resolver\
])

data = spark.createDataFrame([["The patient is a 30-year-old female with coronary artery disease and swelling affecting the kidney and lower limb."]]).toDF("text")
result = pipeline.fit(data).transform(data)

val documentAssembler = new DocumentAssembler()
    .setInputCol("text")
    .setOutputCol("document")

val sentenceDetectorDL = SentenceDetectorDLModel
    .pretrained("sentence_detector_dl_healthcare", "en", "clinical/models")
    .setInputCols(Array("document"))
    .setOutputCol("sentence")

val tokenizer = new Tokenizer()
    .setInputCols("sentence")
    .setOutputCol("token")

val word_embeddings = WordEmbeddingsModel
    .pretrained("embeddings_clinical", "en", "clinical/models")
    .setInputCols(Array("sentence", "token"))
    .setOutputCol("embeddings")

val ner_jsl = MedicalNerModel
    .pretrained("ner_jsl", "en", "clinical/models")
    .setInputCols(Array("sentence", "token", "embeddings"))
    .setOutputCol("ner_jsl_tags")

val ner_jsl_converter = new NerConverterInternal()
    .setInputCols(Array("sentence", "token", "ner_jsl_tags"))
    .setOutputCol("ner_chunk_jsl")
    .setWhiteList(Array("Disease_Syndrome_Disorder", "External_body_part_or_region"))
    .setReplaceLabels(Map("Disease_Syndrome_Disorder" -> "BodyPart", "External_body_part_or_region" -> "BodyPart"))

val ner_anatomy = MedicalNerModel
    .pretrained("ner_anatomy_coarse", "en", "clinical/models")
    .setInputCols(Array("sentence", "token", "embeddings"))
    .setOutputCol("ner_anatomy_tags")

val ner_anatomy_converter = new NerConverterInternal()
    .setInputCols(Array("sentence", "token", "ner_anatomy_tags"))
    .setOutputCol("ner_chunk_anatomy")
    .setReplaceLabels(Map("Anatomy" -> "BodyPart"))

val ner_oncology_anatomy = MedicalNerModel
    .pretrained("ner_oncology_anatomy_general", "en", "clinical/models")
    .setInputCols(Array("sentence", "token", "embeddings"))
    .setOutputCol("ner_oncology_anatomy_tags")

val ner_oncology_anatomy_converter = new NerConverterInternal()
    .setInputCols(Array("sentence", "token", "ner_oncology_anatomy_tags"))
    .setOutputCol("ner_chunk_oncology_anatomy")
    .setReplaceLabels(Map("Anatomical_Site" -> "BodyPart"))

val chunk_merger = new ChunkMergeApproach()
    .setInputCols(Array("ner_chunk_jsl", "ner_chunk_anatomy", "ner_chunk_oncology_anatomy"))
    .setOutputCol("ner_chunk")

val chunk2doc = new Chunk2Doc()
    .setInputCols(Array("ner_chunk"))
    .setOutputCol("ner_chunk_doc")

val embedder = MPNetEmbeddings
    .pretrained("mpnet_embeddings_biolord_2023_c", "en")
    .setInputCols(Array("ner_chunk_doc"))
    .setOutputCol("resolver_embeddings")
    .setCaseSensitive(false)
    .setBatchSize(1)

val resolver = SentenceEntityResolverModel
    .pretrained("biolordresolve_snomed_bodyStructure_20260901", "en", "clinical/models")
    .setInputCols(Array("resolver_embeddings"))
    .setOutputCol("snomed_code")
    .setDistanceFunction("EUCLIDEAN")
    .setThreshold(1000)

val pipeline = new Pipeline().setStages(Array(
    documentAssembler, sentenceDetectorDL, tokenizer, word_embeddings, ner_jsl, ner_jsl_converter, ner_anatomy, ner_anatomy_converter, ner_oncology_anatomy, ner_oncology_anatomy_converter, chunk_merger, chunk2doc, embedder, resolver
))

val data = Seq("The patient is a 30-year-old female with coronary artery disease and swelling affecting the kidney and lower limb.").toDF("text")
val res = pipeline.fit(data).transform(data)

Results

| chunk           | label    |   snomed_code | resolution      | all_codes                                                                           | all_resolutions                                                                     |
|:----------------|:---------|--------------:|:----------------|:------------------------------------------------------------------------------------|:------------------------------------------------------------------------------------|
| coronary artery | BodyPart |      41801008 | coronary artery | 41801008:::360487004:::244248004:::57396003:::50018008:::181294004:::119204004::... | coronary artery:::segment of coronary artery:::branch of left coronary artery:::... |
| kidney          | BodyPart |      64033007 | kidney          | 64033007:::181414000:::119219003:::54018001:::29704000:::25990002:::17373004:::3... | kidney:::entire kidney:::kidney part:::nephron structure:::renal parenchyma:::re... |
| lower limb      | BodyPart |      61685007 | lower limb      | 61685007:::127951001:::30021000:::128263001:::69548008:::120575009:::182281004::... | lower limb:::lower extremity region:::lower leg:::lower body:::lower body part::... |

Model Information

Model Name: biolordresolve_snomed_bodyStructure_20260901
Compatibility: Healthcare NLP 6.4.1+
License: Licensed
Edition: Official
Input Labels: [embeddings]
Output Labels: [snomed_code]
Language: en
Size: 200.1 MB
Case sensitive: false