Skip to content

Commit ce854cd

Browse files
committed
small changes for Pub Prev RO doc
1 parent 77175b4 commit ce854cd

File tree

4 files changed

+59
-38
lines changed

4 files changed

+59
-38
lines changed

articles/azure-health-insights/radiology-insights/TOC.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ items:
1515
- name: Transparency note for Radiology Insights
1616
href: transparency-note.md
1717
- name: Data, privacy, and security
18-
href: /azure/azure-health-insights/responsible-ai/data-privacy-security?toc=/azure/azure-health-insights/oncophenotype/toc.json
18+
href: /azure/azure-health-insights/responsible-ai/data-privacy-security?toc=/azure/azure-health-insights/radiology-insights/toc.json
1919
- name: Concepts
2020
items:
2121
- name: Model configuration
@@ -25,7 +25,7 @@ items:
2525
- name: Reference
2626
items:
2727
- name: REST API
28-
href: /rest/api/cognitiveservices/healthinsights/radiologyinsights
28+
href: /rest/api/cognitiveservices/healthinsights/radiology-insights
2929
- name: SDKs
3030
items:
3131
- name: .NET

articles/azure-health-insights/radiology-insights/get-started.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ The Service URL to access your service is: https://```YOUR-NAME```.cognitiveserv
2828

2929
To send an API request, you need your Azure AI services account endpoint and key.
3030

31-
You can find a full view of the [request parameters here](/rest/api/cognitiveservices/healthinsights/onco-phenotype/create-job).
31+
You can find a full view of the [request parameters here](/rest/api/cognitiveservices/healthinsights/radiology-insights/create-job).
3232

3333
![[Screenshot of the Keys and Endpoints for the Radiology Insights.](../media/keys-and-endpoints.png)](../media/keys-and-endpoints.png#lightbox)
3434

@@ -124,7 +124,7 @@ Ocp-Apim-Subscription-Key: {cognitive-services-account-key}
124124
}
125125
```
126126

127-
You can also find a full view of the [request parameters here](/rest/api/cognitiveservices/healthinsights/onco-phenotype/create-job).
127+
You can also find a full view of the [request parameters here](/rest/api/cognitiveservices/healthinsights/radiology-insights/create-job).
128128

129129
### Evaluating a response that contains a case
130130

articles/azure-health-insights/radiology-insights/inferences.md

Lines changed: 41 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ ms.author: JanSchietse
1414

1515
# Inference information
1616

17-
This document describes details of all inferences generated by application of RI to a radiology document.
17+
This document describes the details of all inferences generated by application of RI to a radiology document.
1818

1919
The Radiology Insights feature of Azure Health Insights uses natural language processing techniques to process unstructured medical radiology documents. It adds several types of inferences that help the user to effectively monitor, understand, and improve financial and clinical outcomes in a radiology workflow context.
2020

@@ -63,10 +63,12 @@ To interact with the Radiology-Insights model, you can provide several model con
6363
An age mismatch occurs when the document gives a certain age for the patient, which differs from the age that is calculated based on the patient’s info birthdate and the encounter period in the request.
6464
- kind: RadiologyInsightsInferenceType.AgeMismatch;
6565

66-
<details><summary>Examples request/response json</summary>
66+
Examples request/response json:
67+
6768
[!INCLUDE [Example input json](../includes/example-inference-age-mismatch-json-request.md)]
69+
6870
[!INCLUDE [Example output json](../includes/example-inference-age-mismatch-json-response.md)]
69-
</details>
71+
7072

7173

7274

@@ -96,10 +98,12 @@ The meaning of this field is as follows:
9698
A mismatch with discrepancy type “textLaterityMissing” has no token extensions.
9799

98100

99-
<details><summary>Examples request/response json</summary>
101+
Examples request/response json:
102+
100103
[!INCLUDE [Example input json](../includes/example-inference-laterality-discrepancy-json-request.md)]
104+
101105
[!INCLUDE [Example output json](../includes/example-inference-laterality-discrepancy-json-response.md)]
102-
</details>
106+
103107

104108

105109

@@ -112,10 +116,12 @@ Field “sexIndication” contains one coding with a SNOMED concept for either M
112116
- 248152002: FEMALE (FINDING)
113117

114118

115-
<details><summary>Examples request/response json</summary>
119+
Examples request/response json:
120+
116121
[!INCLUDE [Example input json](../includes/example-inference-sex-mismatch-json-request.md)]
122+
117123
[!INCLUDE [Example output json](../includes/example-inference-sex-mismatch-json-response.md)]
118-
</details>
124+
119125

120126

121127

@@ -137,10 +143,12 @@ Fields “missingBodyParts” and/or “missingBodyPartsMeasurements” contain
137143

138144

139145

140-
<details><summary>Examples request/response json</summary>
146+
Examples request/response json:
147+
141148
[!INCLUDE [Example input json](../includes/example-inference-complete-order-discrepancy-json-request.md)]
149+
142150
[!INCLUDE [Example output json](../includes/example-inference-complete-order-discrepancy-json-response.md)]
143-
</details>
151+
144152

145153

146154

@@ -162,10 +170,12 @@ Field “ordertype” contains one Coding, with one of the following Loinc codes
162170
Fields “presentBodyParts” and/or “presentBodyPartsMeasurements” contain body parts (radlex codes) that are present or whose measurements are present. The token extensions refer to body parts or measurements that are present (or words that imply them).
163171

164172

165-
<details><summary>Examples request/response json</summary>
173+
Examples request/response json:
174+
166175
[!INCLUDE [Example input json](../includes/example-inference-limited-order-discrepancy-json-request.md)]
176+
167177
[!INCLUDE [Example output json](../includes/example-inference-limited-order-discrepancy-json-response.md)]
168-
</details>
178+
169179

170180

171181

@@ -204,12 +214,6 @@ list of fields within field “finding”, except “component”:
204214

205215
In this list, the string before the colon is the code, and the string after the colon is the display name.
206216
If the value is “NONE (QUALIFIER VALUE)”, the finding is absent. This value is, for example, “no sepsis”.
207-
category: if filled, this field contains an array with one element. It contains one of the following SNOMED concepts:
208-
- 439401001: DIAGNOSIS (OBSERVABLE ENTITY)
209-
- 404684003: CLINICAL FINDING (FINDING)
210-
- 162432007: SYMPTOM: GENERALIZED (FINDING)
211-
- 246501002: TECHNIQUE (ATTRIBUTE)
212-
- 91722005: PHYSICAL ANATOMICAL ENTITY (BODY STRUCTURE)
213217

214218
code:
215219
- SNOMED code 404684003: CLINICAL FINDING (FINDING) (meaning that the finding has a clinical indicator)
@@ -278,10 +282,12 @@ If “valueQuantity” is set, then “valueQuantity.value” is always set. In
278282
If “valueRange” is set, then “valueRange.low” and “valueRange.high” are set to quantities with the same data as described in the previous paragraph. This field contains, for example, “The tumor is between 2.5 cm and 2.6 cm in size".
279283

280284

281-
<details><summary>Examples request/response json</summary>
285+
Examples request/response json:
286+
282287
[!INCLUDE [Example input json](../includes/example-inference-finding-json-request.md)]
288+
283289
[!INCLUDE [Example output json](../includes/example-inference-finding-json-response.md)]
284-
</details>
290+
285291

286292

287293

@@ -296,10 +302,12 @@ Field “result.finding”, if set, contains the same information as the “find
296302
Next to token extensions, there can be an extension for a section. This field contains the most specific section that the first token of the critical result is in (or to be precise, the first token that is in a section). This section is in the same format as a section for a finding.
297303

298304

299-
<details><summary>Examples request/response json</summary>
305+
Examples request/response json:
306+
300307
[!INCLUDE [Example input json](../includes/example-inference-critical-result-json-request.md)]
308+
301309
[!INCLUDE [Example output json](../includes/example-inference-critical-result-json-response.md)]
302-
</details>
310+
303311

304312

305313

@@ -357,10 +365,12 @@ This type has the following fields, the first 2 of which are always filled:
357365
- “view”: not set.
358366

359367

360-
<details><summary>Examples request/response json</summary>
368+
Examples request/response json:
369+
361370
[!INCLUDE [Example input json](../includes/example-1-inference-follow-up-recommendation-json-request.md)]
371+
362372
[!INCLUDE [Example output json](../includes/example-1-inference-follow-up-recommendation-json-response.md)]
363-
</details>
373+
364374

365375

366376

@@ -374,10 +384,12 @@ This inference is created when findings or test results were communicated to a m
374384

375385
Field “wasAcknowledged” is set to true if the communication was verbal (nonverbal communication might not have reached the recipient yet and cannot be considered acknowledged). Field “dateTime” is set if the date-time of the communication is known. Field “recipient” is set if the recipient(s) are known. See the OpenAPI spec for its possible values.
376386

377-
<details><summary>Examples request/response json</summary>
387+
Examples request/response json:
388+
378389
[!INCLUDE [Example input json](../includes/example-inference-follow-up-communication-json-request.md)]
390+
379391
[!INCLUDE [Example output json](../includes/example-inference-follow-up-communication-json-response.md)]
380-
</details>
392+
381393

382394

383395

@@ -394,10 +406,12 @@ Field “procedureCodes”, if set, contains LOINC codes.
394406
Field “orderedProcedure” contains the description(s) and the code(s) of the ordered procedure(s) as given by the client. The descriptions are in field “orderedProcedure.description”, separated by “;;”. The codes are in “orderedProcedure.code.coding”. In every coding in the array, only field “coding” is set.
395407

396408

397-
<details><summary>Examples request/response json</summary>
409+
Examples request/response json:
410+
398411
[!INCLUDE [Example input json](../includes/example-inference-radiology-procedure-json-request.md)]
412+
399413
[!INCLUDE [Example output json](../includes/example-inference-radiology-procedure-json-response.md)]
400-
</details>
414+
401415

402416

403417

articles/azure-health-insights/radiology-insights/model-configuration.md

Lines changed: 14 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -66,11 +66,14 @@ false | No Evidence is returned
6666
- type: boolean
6767
- description: Provide a single focused sentence as evidence for the recommendation, default is false.
6868

69-
When includeEvidence is false, no evidence is returned.
7069

71-
This configuration overrules includeRecommendationsWithNoSpecifiedModality and provideFocusedSentenceEvidence and no evidence is shown.
70+
IncludeEvidence
71+
72+
- IncludeEvidence
73+
- type: boolean
74+
- Provide evidence for the inference, default is false, no evidence is returned.
75+
7276

73-
When includeEvidence is true, it depends on the value set on the two other configurations whether the evidence of the inference or a single focused sentence is given as evidence.
7477

7578
## Examples
7679

@@ -86,10 +89,12 @@ As a result, the model includes evidence for all inferences.
8689
- The model checks for follow-up recommendations with no specific radiologic modality.
8790
- The model provides a single focused sentence as evidence for the recommendation.
8891

89-
<details><summary>Examples request/response json</summary>
92+
Examples request/response json:
93+
9094
[!INCLUDE [Example input json](../includes/example-2-inference-follow-up-recommendation-json-request.md)]
95+
9196
[!INCLUDE [Example output json](../includes/example-2-inference-follow-up-recommendation-json-response.md)]
92-
</details>
97+
9398

9499

95100

@@ -105,10 +110,12 @@ As a result, the model includes evidence for all inferences.
105110
- The model provides a single focused sentence as evidence for the finding.
106111

107112

108-
<details><summary>Examples request/response json</summary>
113+
Examples request/response json:
114+
109115
[!INCLUDE [Example input json](../includes/example-1-inference-follow-up-recommendation-json-request.md)]
116+
110117
[!INCLUDE [Example output json](../includes/example-1-inference-follow-up-recommendation-json-response.md)]
111-
</details>
118+
112119

113120

114121

0 commit comments

Comments
 (0)