<\/p>\n
We’re pleased to announce that Text Analytics now supports healthcare analysis and multiple actions analysis in preview.<\/p>\n
Healthcare Entities Analysis<\/a><\/p>\n<\/li>\n Multiple Actions Analysis<\/a><\/p>\n<\/li>\n<\/ul>\n Text Analytics for Healthcare is a containerized service that extracts and labels relevant medical information from unstructured texts such as doctor’s notes, discharge summaries, clinical documents, and electronic healthcare records.<\/p>\n Text Analytics for Healthcare is in preview. If you are interested in trying it out, please see how to use Text Analytics for Healthcare<\/a> to request access<\/a>. Note: Azure Active Directory (AAD) is not currently supported at this stage of the development<\/p>\n Text Analytics for Healthcare supports the following features:<\/p>\n Named entity recognition<\/a>: Detects words and phrases mentioned in unstructured text as entities that can be associated with semantic types in the healthcare and biomedical domain, such as diagnosis, medication name, symptoms\/signs, examinations, treatments, dosage, and route of administration. (For a full list of healthcare entity types and relationships, see the supported entity categories<\/a>.)<\/p>\n<\/li>\n Entity data source linking<\/a>: Disambiguates distinct entities by associating named entities mentioned in text to concepts found in a predefined database of concepts including the Unified Medical Language System (UMLS). Medical concepts are also assigned preferred naming as an additional form of normalization.<\/p>\n<\/li>\n Assertion detection<\/a>: The meaning of medical content is highly affected by modifiers, such as negative or conditional assertions which can have critical implications if misrepresented. There are three categories of assertion detection we support for entities in the text:<\/p>\n For more information about the assertion output, view assertion output<\/a>.<\/p>\n<\/li>\n Entities relation extraction<\/a>: Relation extraction identifies meaningful connections between concepts mentioned in text. For examples, a “time of condition” relation is found by associating a condition name with a time.<\/p>\n<\/li>\n<\/ul>\n In this blog, we’ll use Java as the primary language to show the healthcare entities analysis feature. To see the complete sample, see Java sample<\/a>. For more information about other languages, refer to .NET sample<\/a>, JS sample<\/a>, Python sample<\/a>.<\/p>\n To use Text Analytics for Healthcare, start with creating a Text Analytics client, and then use the client to make a request to the Text Analytics service on the healthcare documents input, which will return the analyzed output that includes the features described above.<\/p>\n Please see how to authenticate the client<\/a> for using the Text Analytics service.<\/p>\n Get documents<\/p>\n Begin a “healthcare entities analysis” long-running operation, it might take a few seconds to complete. You would be able to get the operation details in To view the operation details,<\/p>\n To view the final result of the long-running operation.<\/p>\n One action represents one single operation that Text Analytics supports, such as the We’ll now use Java as the primary language to show the multiple actions analysis feature. To see the full complete sample, see Java sample<\/a>. For more information about other languages, refer to .NET sample<\/a>, JS sample<\/a>, Python sample<\/a>.<\/p>\n We can use the same Text Analytics client we created above<\/a> in the healthcare to analyze the documents input. The output will include all action results.<\/p>\n Begin a long-running multiple actions analysis operation.<\/p>\n To view the final result of long-running operation. An action result could either be an action error or a successful result. That pattern applies to each document result as well.<\/p>\n This article introduced the new Text Analytics library features for healthcare entities analysis<\/a> and multiple actions analysis.<\/p>\n For more information about the features in this article in other programming languages, see the following:<\/p>\n <\/p>\n Thank you for reading this Azure SDK blog post! We hope that you learned something new and welcome you to share this post. We are open to Azure SDK blog contributions. Please contact us at azsdkblog@microsoft.com<\/a> with your topic and we’ll get you set up as a guest blogger.<\/p>\n <\/p>\n","protected":false},"excerpt":{"rendered":" This article introduces the new Text Analytics features for analyzing healthcare entities and running multiple actions.<\/p>\n","protected":false},"author":56388,"featured_media":1051,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[160,793,792],"class_list":["post-1050","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-azure-sdk","tag-java","tag-preview","tag-text-analytics"],"acf":[],"blog_post_summary":" This article introduces the new Text Analytics features for analyzing healthcare entities and running multiple actions.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/posts\/1050","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/users\/56388"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/comments?post=1050"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/posts\/1050\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/media\/1051"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/media?parent=1050"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/categories?post=1050"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/tags?post=1050"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}Healthcare Entities Analysis<\/h2>\n
\n
\n
An example: Using Text Analytics for Healthcare in Java<\/h3>\n
Create a Text Analytics client<\/h4>\n
TextAnalyticsClient client = new TextAnalyticsClientBuilder()\n .credential(new AzureKeyCredential(\"{key}\"))\n .endpoint(\"{endpoint}\")\n .buildClient();\n<\/code><\/pre>\nList<TextDocumentInput> documents = Arrays.asList(\n new TextDocumentInput(\"0\",\n \"Woman in NAD with a h\/o CAD, DM2, asthma and HTN on ramipril for 8 years awoke from sleep around\" \n + \" 2:30 am this morning of a sore throat and swelling of tongue. She came immediately to the ED\" \n + \" b\/c she was having difficulty swallowing.\"),\n new TextDocumentInput(\"1\",\n \"Patient's brother died at the age of 64 from lung cancer. She was admitted for likely gastroparesis\"\n + \" but remains unsure if she wants to start adjuvant hormonal therapy. Please hold lactulose \"\n + \"if diarrhea worsen.\")); \n<\/code><\/pre>\nAnalyzeHealthcareEntitiesOperationDetail<\/code> and the final operation result in AnalyzeHealthcareEntitiesResultCollection<\/code>.<\/p>\nSyncPoller<AnalyzeHealthcareEntitiesOperationDetail, PagedIterable<AnalyzeHealthcareEntitiesResultCollection>>\n syncPoller = client.beginAnalyzeHealthcareEntities(documents, options, Context.NONE);\n\nSystem.out.printf(\"Poller status: %s.%n\", syncPoller.poll().getStatus());\n\nsyncPoller.waitForCompletion();\n<\/code><\/pre>\nAnalyzeHealthcareEntitiesOperationDetail operationResult = syncPoller.poll().getValue();\nSystem.out.printf(\"Operation created time: %s, expiration time: %s.%n\", operationResult.getCreatedAt(),\n operationResult.getExpiresAt());\nSystem.out.printf(\"Poller status: %s.%n\", syncPoller.poll().getStatus());\n<\/code><\/pre>\nfor (AnalyzeHealthcareEntitiesResultCollection healthcareEntitiesResultCollection : syncPoller.getFinalResult()) {\n \/\/ documents result\n for (AnalyzeHealthcareEntitiesResult healthcareEntitiesResult : healthcareEntitiesResultCollection) {\n System.out.println(\"Document entities: \");\n \/\/ Recognized healthcare entities\n for (HealthcareEntity entity : healthcareEntitiesResult.getEntities()) {\n System.out.printf(\"\tText: %s, normalized name: %s, category: %s, confidence score: %f.%n\",\n entity.getText(), entity.getNormalizedText(), entity.getCategory(), entity.getConfidenceScore());\n \/\/ Assertion detection\n HealthcareEntityAssertion assertion = entity.getAssertion();\n if (assertion != null) {\n System.out.printf(\"\t\tEntity assertion: association=%s, certainty=%s, conditionality=%s.%n\",\n assertion.getAssociation(), assertion.getCertainty(), assertion.getConditionality());\n }\n \/\/ Entity data source linking\n for (EntityDataSource dataSource : entity.getDataSources()) {\n System.out.printf(\"\t\tEntity ID in data source: %s, data source: %s.%n\",\n dataSource.getEntityId(), dataSource.getName());\n }\n }\n \/\/ Relation extraction\n for (HealthcareEntityRelation entityRelation : healthcareEntitiesResult.getEntityRelations()) {\n System.out.printf(\"Relation type: %s.%n\", entityRelation.getRelationType());\n for (HealthcareEntityRelationRole role : entityRelation.getRoles()) {\n HealthcareEntity entity = role.getEntity();\n System.out.printf(\"\tEntity text: %s, category: %s, role: %s.%n\",\n entity.getText(), entity.getCategory(), role.getName());\n }\n }\n }\n}\n<\/code><\/pre>\nMultiple Actions Analysis<\/h2>\n
Key Phrase Extraction<\/code> operation would be considered as one action. Text Analytics now provides a way to run multiple actions in one or more documents as a single long-running operation. Currently, Text Analytics for the multiple actions analytics only supports:<\/p>\n\n
An example: Using Text Analytics for Multiple Actions in Java<\/h3>\n
SyncPoller<AnalyzeBatchActionsOperationDetail, PagedIterable<AnalyzeBatchActionsResult>> syncPoller =\n client.beginAnalyzeBatchActions(documents,\n new TextAnalyticsActions().setDisplayName(\"{tasks_display_name}\")\n .setRecognizeEntitiesOptions(new RecognizeEntitiesOptions())\n .setExtractKeyPhrasesOptions(new ExtractKeyPhrasesOptions()),\n new AnalyzeBatchActionsOptions().setIncludeStatistics(false),\n Context.NONE);\n\nsyncPoller.waitForCompletion();\n<\/code><\/pre>\nfor (AnalyzeBatchActionsResult actionsResult : syncPoller.getFinalResult()) {\n System.out.println(\"Entities recognition action results:\");\n for (RecognizeEntitiesActionResult actionResult : actionsResult.getRecognizeEntitiesActionResults()) {\n if (!actionResult.isError()) {\n for (RecognizeEntitiesResult documentResult : actionResult.getResult()) {\n if (!documentResult.isError()) {\n for (CategorizedEntity entity : documentResult.getEntities()) {\n System.out.printf(\"Recognized entity: %s, entity category: %s, confidence score: %f.%n\",\n entity.getText(), entity.getCategory(), entity.getConfidenceScore());\n }\n } else {\n System.out.printf(\"Cannot recognize entities. Error: %s%n\",\n documentResult.getError().getMessage());\n }\n }\n } else {\n System.out.printf(\"Cannot execute Entities Recognition action. Error: %s%n\",\n actionResult.getError().getMessage());\n }\n }\n\n System.out.println(\"Key phrases extraction action results:\");\n for (ExtractKeyPhrasesActionResult actionResult : actionsResult.getExtractKeyPhrasesActionResults()) {\n if (!actionResult.isError()) {\n for (ExtractKeyPhraseResult documentResult : actionResult.getResult()) {\n if (!documentResult.isError()) {\n System.out.println(\"Extracted phrases:\");\n for (String keyPhrases : documentResult.getKeyPhrases()) {\n System.out.printf(\"\t%s.%n\", keyPhrases);\n }\n } else {\n System.out.printf(\"Cannot extract key phrases. Error: %s%n\", \n documentResult.getError().getMessage());\n }\n }\n } else {\n System.out.printf(\"Cannot execute Key Phrases Extraction action. Error: %s%n\",\n actionResult.getError().getMessage());\n }\n }\n}\n<\/code><\/pre>\nSummary<\/h2>\n
\n
Azure SDK Blog Contributions<\/h2>\n
Azure SDK Links<\/h2>\n
\n