Skip to content

Commit f32a8b5

Browse files
committed
Fix: typos/grammar
1 parent 181864b commit f32a8b5

8 files changed

Lines changed: 32 additions & 33 deletions

File tree

docs/explore-and-author/graph-exploration/graph-insights/concepts.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ Start the exploration by dragging a **class** from the [class tree](features/cat
4949

5050
### 2. Expand (Traverse)
5151

52-
Add groups of connected resources by expanding the exploration tree: Point at a group and click the arrow that appears to its right to view the connected top-level classes, then select a object property and direction.
52+
Add groups of connected resources by expanding the exploration tree: point at a group and click the arrow that appears to its right to view the connected top-level classes, then select an object property and direction.
5353

5454
*Example:*
5555

@@ -76,11 +76,11 @@ Open the [resource table](features/objects-table.md) to access the highly config
7676

7777
#### Connection
7878

79-
Select a connection beam and open the [connection table](features/connections.md#connection-table) to access the highly configurable tabular listing of all object property assertions between the left and right group and their data properties.
79+
Select a connection beam and open the [connection table](features/connections.md#connection-table) to access the highly configurable tabular listing of all object property assertions between the left and right group and their data properties.
8080

8181
### 4. Refine (Filter)
8282

83-
Narrow down any group to your match your current focus using [data property filters](features/objects-table.md#filtering) and [class histograms](features/groups.md#histograms).
83+
Narrow down any group to match your current focus using [data property filters](features/objects-table.md#filtering) and [class histograms](features/groups.md#histograms).
8484

8585
*Example:*
8686

@@ -94,4 +94,4 @@ Narrow down any group to your match your current focus using [data property filt
9494
- **Images:** [Export](features/persistence.md#export-visuals) the canvas as SVG or PNG images.
9595
- **CSV data:** Download of the resources of a group or of the table view of a group or connection.
9696
- **Query snippets:** Copy the SPARQL that returns the resources of a group or the data in the table view of a group or connection for use (e.g. a dashboard).
97-
- **[JSON Sharing](features/persistence.md#json-sharing):** Share explorations as JSON-serialization.
97+
- **[JSON Sharing](features/persistence.md#json-sharing):** Share explorations as JSON-serialization.

docs/explore-and-author/graph-exploration/graph-insights/features/category-tree.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ The tree is the primary tool to populate the canvas:
3838
**Deactivating** a class hides it from the **expansion menu** on the canvas, streamlining the exploration workflow. This is useful for hiding abstract classes (e.g., `Entity`, `Thing`) that render the exploration more tedious.
3939

4040
- **Action:** Right-click a class and select `Deactivate class`.
41-
- **Outcome:** The item turns **light gray**. Expansions steps will skip this class and offer **its direct sub-class** instead.
41+
- **Outcome:** The item turns **light gray**. Expansion steps will skip this class and offer **its direct sub-class** instead.
4242

4343
!!! danger "Caution"
4444

@@ -54,4 +54,4 @@ The tree is the primary tool to populate the canvas:
5454

5555
## Class Tree Configuration Reset
5656

57-
To return the class tree configuration to its initial state, click the **circular arrow icon** in the pane header. This action restores all deactivated classes and reverts caption settings to defaults.
57+
To return the class tree configuration to its initial state, click the **circular arrow icon** in the pane header. This action restores all deactivated classes and reverts caption settings to defaults.

docs/explore-and-author/graph-exploration/graph-insights/features/objects-table.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ Filtering is a two-step process to prevent unnecessary database queries.
3636
- **Outcome:** The table updates immediately to preview the result, and the column header displays an **hourglass icon (⧖)** (symbolizes filtering).
3737
- Repeat with further columns as necessary.
3838
2. **Apply:** Click `Apply filters` (top-left).
39-
- **Outcome:** The group in the canvas updates, and a **half full disk icon (◐)** appears on the group (symbolizes partial content, the caption does not describe the group totally as it has been filtered).
39+
- **Outcome:** The group on the canvas updates, and a **half full disk icon (◐)** appears on the group (indicating filtered content).
4040

4141
![Filter Status Icons](../assets/filtered-group-and-column.png){ class="bordered" width="85%" }
4242

@@ -78,4 +78,3 @@ Unlike the bulk group export, table exports respect the **current view** (filter
7878
- The query is intended to be used directly on the database for various datasets with the same model (or slight variations thereof).
7979
- The table query was designed for dashboard integration. Make sure to configure the table to match exactly your requirements.
8080
- The query might look overcomplicated but it includes lots of special case handling to replicate the table view as close as possible.
81-

docs/explore-and-author/graph-exploration/graph-insights/features/objects.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,7 @@ Most flagging actions that might affect numerous nodes create temporary flags fo
7272

7373
## Paths Highlighting and Flagging
7474

75-
Visualize upstream and downstream connections of an resource in the exploration tree.
75+
Visualize upstream and downstream connections of a resource in the exploration tree.
7676

7777
**Highlighting:**
7878

@@ -99,7 +99,7 @@ Visualize upstream and downstream connections of an resource in the exploration
9999

100100
In the **groups in instance rendering mode** (count <= threshold), Graph Insights visually encodes the local "centrality" of resources based on their connectivity to the previous group in the exploration tree (if any).
101101

102-
- **Definition:** The **number of predecessors** of an resource is the number of distinct resources from the *previous* group in the current branch of the exploration tree connected to it.
102+
- **Definition:** The **number of predecessors** of a resource is the number of distinct resources from the *previous* group in the current branch of the exploration tree connected to it.
103103
- **Visualization:**
104104
- The number of predecessors is displayed in the dot representing the resources, no number meaning there is only a single predecessor.
105105
- The highly connected resources (i.e., with higher predecessor counts) are located at the center of the groups.
@@ -123,7 +123,7 @@ Analysts can focus on a specific resource within a group to analyze its relation
123123

124124
Expand the exploration with specific connections from a single resource within a larger group.
125125

126-
- **Action:** Right-click an resource to open its context menu, open `Explore connections of the resource`, and select the target class and connecting object property and direction (just like a group expansion).
126+
- **Action:** Right-click a resource to open its context menu, open `Explore connections of the resource`, and select the target class and connecting object property and direction (just like a group expansion).
127127
- **Outcome:** A new connection beam connects the individual resource to a new group to its right.
128128

129129
![Expand Individual Object](../assets/expand-object-from-group.png){ class="bordered" width="75%" }

docs/explore-and-author/graph-exploration/graph-insights/features/persistence.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ Add context to the analysis by attaching text notes to important groups.
6060
They act as **"virtual classes"**, refining the model within the exploration layer without altering the underlying ontology.
6161

6262

63-
A user-defined Graph Insights Classes can be defined for any group in any exploration (e.g., "High-volume suppliers located in Germany").
63+
A user-defined Graph Insights class can be defined for any group in any exploration (e.g., "High-volume suppliers located in Germany").
6464

6565
- **Action:** Right-click the group or its caption to open its context menu and select `Add Graph Insights class for this group`.
6666
- **Outcome:**
@@ -108,4 +108,4 @@ Export the current canvas state for reporting.
108108
- **Formats:**
109109
- **Raster (PNG):** For slides and quick sharing.
110110
- **Vector (SVG):** For high-resolution print or editing.
111-
111+

docs/explore-and-author/graph-exploration/graph-insights/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ A specific configuration is required to activate this feature.
3434
In order to manage Graph Insights snapshots, you can use the
3535
[`graph insights`](../../../automate/cmemc-command-line-interface/command-reference/graph/insights/index.md)
3636
command group of cmemc.
37-
With this command group, you can list, create, delete, and inspect graph insight snapshots.
37+
With this command group, you can list, create, delete, and inspect Graph Insights snapshots.
3838

3939
## Automation
4040

@@ -49,7 +49,7 @@ The **user guide** presents the visual analysis workflow of Graph Insights. It d
4949

5050
### Where to Start?
5151

52-
1. **[Core Concepts](concepts.md):** *(Recommended)* Before diving in, understand the **aggregated exploration tree** paradigm of Graph Insights that prevents the visual clutter of traditional force-directed graph-renderings ("hairballs").
52+
1. **[Core Concepts](concepts.md):** *(Recommended)* Before diving in, understand the **aggregated exploration tree** paradigm of Graph Insights that prevents the visual clutter of traditional force-directed graph renderings ("hairballs").
5353

5454
2. **[Tutorial: Supply Chain Analysis](tutorial.md):** A step-by-step walkthrough using the Northwind dataset. Learn how to filter for **VIP customers**, analyze **product vulnerabilities**, and use **backpropagation** to propagate filtering.
5555

docs/explore-and-author/graph-exploration/graph-insights/navigating-to-cmem.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,31 +6,31 @@ Graph Insights allows you to seamlessly jump from your visual analysis directly
66

77
## Navigating from a Class
88

9-
You can open the CMEM view of a specific Class directly from the Class Tree.
9+
You can open the CMEM view of a specific class directly from the class tree.
1010

11-
- **Action:** Right-click a Class in the left pane tree to open its context menu.
11+
- **Action:** Right-click a class in the left pane tree to open its context menu.
1212
- **Select:** `View in CMEM`.
13-
- **Outcome:** The corresponding Class model opens in a new tab.
13+
- **Outcome:** The corresponding class model opens in a new tab.
1414

1515
![View Class in CMEM](graph-insights-view-in-cmem-classes.png){ class="bordered" width="65%" }
1616

1717
---
1818

1919
## Navigating from a Resource
2020

21-
If you isolate a specific Resource of interest during your exploration, you can instantly inspect its full source record.
21+
If you isolate a specific resource of interest during your exploration, you can instantly inspect its full source record.
2222

2323
There are two ways to trigger this navigation:
2424

2525
**From the Canvas**
2626

27-
- **Action:** Right-click a specific Resource dot within a group to open its context menu.
27+
- **Action:** Right-click a specific resource dot within a group to open its context menu.
2828
- **Select:** `View in CMEM`.
2929

3030
![View Resource in CMEM from Canvas](graph-insights-view-in-cmem-resources.png){ class="bordered" width="75%" }
3131

3232
**From the Details Pane**
3333

34-
- **Action:** Select a Resource on the canvas or in the Resource table to load its details in the right pane.
34+
- **Action:** Select a resource on the canvas or in the resource table to load its details in the right pane.
3535
- **Select:** Click the `View in CMEM` button located at the top of the Details pane.
3636
- **Outcome:** The specific instance record opens in a new tab.

docs/explore-and-author/graph-exploration/graph-insights/tutorial.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Northwind Traders needs to identify vulnerabilities in the trade network by answ
1313
We will traverse the ordering chain, identify high-volume US partners, and isolate the product mix.
1414

1515
---
16-
16+
1717
## 1. Seed the Canvas
1818

1919
Every exploration requires a starting point. We begin with the central entity: The **product**.
@@ -26,7 +26,7 @@ Every exploration requires a starting point. We begin with the central entity: T
2626

2727
---
2828

29-
## 2. Build Traversals to the Interest Groups
29+
## 2. Build Traversals to the Interest Groups
3030

3131
Next, we expand the exploration tree to connect Suppliers and Customers.
3232

@@ -61,7 +61,7 @@ The exploration tree currently visualizes all connections. We must now isolate t
6161
We define "VIP" as customers with the highest volume of incoming orders.
6262

6363
1. Select the `Customer` group and open the [resource table](features/objects-table.md#objects-table).
64-
2. **Filter by country:** Open the menu of the `country` column from its header (using the menu dropdown or a right-click) and enter `USA` in the textfield of the filter submenu.
64+
2. **Filter by country:** Open the menu of the `country` column from its header (using the menu dropdown or a right-click) and enter `USA` in the text field of the filter submenu.
6565
3. **Identify VIPs:** Click the **Predecessors** column header to **Sort Descending**. This ranks customers by their incoming connection count (number of Orders).
6666

6767
![USA Customer Filter](assets/tutorial-usa-customer-filter.png){ class="bordered" width="80%" }
@@ -71,15 +71,15 @@ We define "VIP" as customers with the highest volume of incoming orders.
7171
![Top USA Customer Filter](assets/tutorial-top-usa-customer-filter.png){ class="bordered" width="85%" }
7272

7373
### 3.2. Isolate UK Suppliers
74-
74+
7575
1. Select the `Supplier` group to open the table.
7676
2. Filter `Country` to `UK`.
7777
3. Click `Apply filters`.
7878

7979
![UK Supplier Filter](assets/tutorial-uk-suppliers-filter.png){ class="bordered" width="85%" }
8080

8181
!!! info "The Disconnected State"
82-
82+
8383
At this stage, you have filtered the *ends* of both traversals, but their *start* (Products) still shows the total inventory (left-join pattern). The branches of the exploration tree represent independent aggregated traversals sharing the same starting point.
8484

8585

@@ -97,16 +97,16 @@ We apply [**left group restriction**](features/connections.md#backpropagation) (
9797

9898
Right-click the connection beam between `Supplier` and `Product` and select `Restrict left group`:
9999

100-
- This retains only products having a UK supplier.
101-
- As this reduces the start group of the second branch of the exploration tree, the `Order` and `Customer` groups might be impacted.
100+
- This retains only products having a UK supplier.
101+
- As this reduces the start group of the second branch of the exploration tree, the `Order` and `Customer` groups might be impacted.
102102

103103
### 4.2. Identify Products ordered by VIP USA Customers
104104

105105
Apply the same restriction to the connections between `Order` and `Customer` as well as between `Product` and `Order`:
106106

107-
- This retains only products appearing in at least one order of at least one VIP USA customer.
107+
- This retains only products appearing in at least one order of at least one VIP USA customer.
108108
- All products having been constrained to have a UK supplier in the previous step, the `Products` group now contains the high risk products.
109-
109+
110110
![Supply Chain with Backpropagation](assets/tutorial-supply-chain-with-backpropragation.png){ class="bordered" width="75%" }
111111

112112
---
@@ -115,9 +115,9 @@ Apply the same restriction to the connections between `Order` and `Customer` as
115115

116116
We have isolated the high risk product group, that we can now analyze:
117117

118-
1. Select the filtered `Product` group to display the [class histogram](features/groups.md#histograms) in the right pane.
118+
1. Select the filtered `Product` group to display the [class histogram](features/groups.md#histograms) in the right pane.
119119
2. Expand the `Product` class bar to display its sub-classes (e.g., *Beverages, Confections*).
120-
3. **Insight:** The products of the `Confections` class are the most represented in this high impact risk group.
120+
3. **Insight:** The products of the `Confections` class are the most represented in this high impact risk group.
121121

122122
![Product Histogram for Supply Chain](assets/tutorial-supply-chain-product-histogram.png){ class="bordered" width="85%" }
123123

@@ -150,4 +150,4 @@ You have successfully modeled a complex dependency network, filtered it by geo-l
150150

151151
- **Share:** [Save the exploration](features/persistence.md#saved-explorations) to share this view with colleagues.
152152
- **Monitor:** [Create a user-defined class](features/persistence.md#custom-categories) called "High-Risk Confections" to permanently track this segment.
153-
- **Report:** [Export the CSV](features/groups.md#group-operations) of the flagged branch for the procurement team.
153+
- **Report:** [Export the CSV](features/groups.md#group-operations) of the flagged branch for the procurement team.

0 commit comments

Comments
 (0)