diff --git a/docs/explore-and-author/graph-exploration/graph-insights/assets/database-summary.png b/docs/explore-and-author/graph-exploration/graph-insights/assets/database-summary.png index a16fe811..3d2ce4d9 100644 Binary files a/docs/explore-and-author/graph-exploration/graph-insights/assets/database-summary.png and b/docs/explore-and-author/graph-exploration/graph-insights/assets/database-summary.png differ diff --git a/docs/explore-and-author/graph-exploration/graph-insights/assets/histogram-flagged-resources.png b/docs/explore-and-author/graph-exploration/graph-insights/assets/histogram-flagged-resources.png index 6a93ea85..2e362671 100644 Binary files a/docs/explore-and-author/graph-exploration/graph-insights/assets/histogram-flagged-resources.png and b/docs/explore-and-author/graph-exploration/graph-insights/assets/histogram-flagged-resources.png differ diff --git a/docs/explore-and-author/graph-exploration/graph-insights/assets/histograms.png b/docs/explore-and-author/graph-exploration/graph-insights/assets/histograms.png index 3e64fad5..445131a8 100644 Binary files a/docs/explore-and-author/graph-exploration/graph-insights/assets/histograms.png and b/docs/explore-and-author/graph-exploration/graph-insights/assets/histograms.png differ diff --git a/docs/explore-and-author/graph-exploration/graph-insights/assets/left-sidebar.png b/docs/explore-and-author/graph-exploration/graph-insights/assets/left-sidebar.png index cecf224f..1e511a13 100644 Binary files a/docs/explore-and-author/graph-exploration/graph-insights/assets/left-sidebar.png and b/docs/explore-and-author/graph-exploration/graph-insights/assets/left-sidebar.png differ diff --git a/docs/explore-and-author/graph-exploration/graph-insights/assets/nested-custom-categories.png b/docs/explore-and-author/graph-exploration/graph-insights/assets/nested-custom-categories.png index 49e877f6..e29c8bf8 100644 Binary files a/docs/explore-and-author/graph-exploration/graph-insights/assets/nested-custom-categories.png and b/docs/explore-and-author/graph-exploration/graph-insights/assets/nested-custom-categories.png differ diff --git a/docs/explore-and-author/graph-exploration/graph-insights/assets/object-dossier.png b/docs/explore-and-author/graph-exploration/graph-insights/assets/object-dossier.png index 651a49a9..58668d5a 100644 Binary files a/docs/explore-and-author/graph-exploration/graph-insights/assets/object-dossier.png and b/docs/explore-and-author/graph-exploration/graph-insights/assets/object-dossier.png differ diff --git a/docs/explore-and-author/graph-exploration/graph-insights/assets/tutorial-start-with-product.png b/docs/explore-and-author/graph-exploration/graph-insights/assets/tutorial-start-with-product.png index 04ed5a63..784fa7db 100644 Binary files a/docs/explore-and-author/graph-exploration/graph-insights/assets/tutorial-start-with-product.png and b/docs/explore-and-author/graph-exploration/graph-insights/assets/tutorial-start-with-product.png differ diff --git a/docs/explore-and-author/graph-exploration/graph-insights/assets/tutorial-supply-chain-expansion.png b/docs/explore-and-author/graph-exploration/graph-insights/assets/tutorial-supply-chain-expansion.png index 3d6ff63e..25414a38 100644 Binary files a/docs/explore-and-author/graph-exploration/graph-insights/assets/tutorial-supply-chain-expansion.png and b/docs/explore-and-author/graph-exploration/graph-insights/assets/tutorial-supply-chain-expansion.png differ diff --git a/docs/explore-and-author/graph-exploration/graph-insights/assets/tutorial-supply-chain-flag-branch-menu.png b/docs/explore-and-author/graph-exploration/graph-insights/assets/tutorial-supply-chain-flag-branch-menu.png index 2080492a..7c49fa2c 100644 Binary files a/docs/explore-and-author/graph-exploration/graph-insights/assets/tutorial-supply-chain-flag-branch-menu.png and b/docs/explore-and-author/graph-exploration/graph-insights/assets/tutorial-supply-chain-flag-branch-menu.png differ diff --git a/docs/explore-and-author/graph-exploration/graph-insights/assets/tutorial-supply-chain-product-histogram.png b/docs/explore-and-author/graph-exploration/graph-insights/assets/tutorial-supply-chain-product-histogram.png index ea5120d6..dad3d22f 100644 Binary files a/docs/explore-and-author/graph-exploration/graph-insights/assets/tutorial-supply-chain-product-histogram.png and b/docs/explore-and-author/graph-exploration/graph-insights/assets/tutorial-supply-chain-product-histogram.png differ diff --git a/docs/explore-and-author/graph-exploration/graph-insights/assets/undo-redo.png b/docs/explore-and-author/graph-exploration/graph-insights/assets/undo-redo.png index a7ff6904..c36dcbab 100644 Binary files a/docs/explore-and-author/graph-exploration/graph-insights/assets/undo-redo.png and b/docs/explore-and-author/graph-exploration/graph-insights/assets/undo-redo.png differ diff --git a/docs/explore-and-author/graph-exploration/graph-insights/assets/user-guide-cover.png b/docs/explore-and-author/graph-exploration/graph-insights/assets/user-guide-cover.png index cb0e0080..e8874cc3 100644 Binary files a/docs/explore-and-author/graph-exploration/graph-insights/assets/user-guide-cover.png and b/docs/explore-and-author/graph-exploration/graph-insights/assets/user-guide-cover.png differ diff --git a/docs/explore-and-author/graph-exploration/graph-insights/concepts.md b/docs/explore-and-author/graph-exploration/graph-insights/concepts.md index f82ea418..d6ec6e95 100644 --- a/docs/explore-and-author/graph-exploration/graph-insights/concepts.md +++ b/docs/explore-and-author/graph-exploration/graph-insights/concepts.md @@ -70,11 +70,11 @@ Access instance-level information like the data property values of the resources #### Single Resource -Select a resource visible inside a group to display its classes and data properties in the right `Details` pane. +Select a resource visible inside a group to display its [details](features/objects.md#object-details) in the right pane (classes and data properties). #### Group -Select a group to display a textual description of its contents and histograms of the distribution of classes of its resources. +Select a group to display its [details](features/groups.md#group-details) in the right pane (a textual description of its contents and histograms of the distribution of classes of its resources). Open the [resource table](features/objects-table.md) to access the highly configurable tabular listing of all resources of the group and their data properties. @@ -99,5 +99,5 @@ Narrow down any group to match your current focus using [data property filters]( - **Images:** [Export](features/persistence.md#export-visuals) the canvas as SVG or PNG images. - **CSV data:** Download of the resources of a group or of the table view of a group or connection. -- **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). +- **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). - **[JSON Sharing](features/persistence.md#json-sharing):** Share explorations as JSON-serialization. \ No newline at end of file diff --git a/docs/explore-and-author/graph-exploration/graph-insights/features/application-settings.md b/docs/explore-and-author/graph-exploration/graph-insights/features/application-settings.md index 0ed5c26b..995716a6 100644 --- a/docs/explore-and-author/graph-exploration/graph-insights/features/application-settings.md +++ b/docs/explore-and-author/graph-exploration/graph-insights/features/application-settings.md @@ -40,6 +40,14 @@ When no group or connection is selected, the right pane displays the **database - **Classes:** Lists all available classes and their cardinality. - **Object Properties:** Lists all object properties with their object property assertions count. -![Database Summary Panel](../assets/database-summary.png){ class="bordered" width="30%" } +![Database Summary Panel](../assets/database-summary.png){ class="bordered" width="35%" } -**Sorting:** Use the `Sort by` dropdown to order lists by `Name` (alphabetical) or `Quantity` (cardinality) to identify the largest entities. \ No newline at end of file +#### Search and View Controls + +Use the controls at the top of the pane to navigate the summary: + +- **Search:** Enter text to filter the summary lists. Use the scope dropdown to restrict the search to `Captions`, `IRIs`, or `All`. +- **View Settings (cogwheel):** + - **Views:** Switch between `Tree view` and `List view`. + - **Sorting:** Order lists using `Sort by name` (alphabetical) or `Sort by count` (cardinality) to identify the largest entities. + - **Hide IRIs:** Toggles the display of the underlying identifiers. \ No newline at end of file diff --git a/docs/explore-and-author/graph-exploration/graph-insights/features/canvas-ui.md b/docs/explore-and-author/graph-exploration/graph-insights/features/canvas-ui.md index cdabb21a..51e0bf26 100644 --- a/docs/explore-and-author/graph-exploration/graph-insights/features/canvas-ui.md +++ b/docs/explore-and-author/graph-exploration/graph-insights/features/canvas-ui.md @@ -2,7 +2,7 @@ # The Exploration Canvas -The **exploration canvas** is the primary workspace in Graph Insights. It displays the exploration tree, allowing users to manipulate layout, throttle data density, and rapidly locate specific resources within the detailed groups. +The **exploration canvas** is the primary workspace in Graph Insights. It displays the exploration tree, allowing users to manipulate layout, throttle data density, and rapidly locate resources within the detailed groups. ## Toolbar Controls @@ -37,7 +37,7 @@ Graph Insights maintains a session history stack. ## Group Rendering Controls (Max. resources) {#object-threshold-logic} To optimize browser performance and visual density, Graph Insights uses two different renderings for groups depending on their cardinality. -Use the `Max. resources` dropdown to set the threshold. +Use the `Max. resources` control in the top toolbar to select a predefined threshold from the dropdown, or click inside the field to enter another number. ### Count-Only Rendering (Count > Threshold) @@ -57,7 +57,7 @@ If the count is *below* the limit, each resource is rendered as a dot within the ## Global Search (Visible Resources) {#global-search} -Locate specific resources **among those currently visible** in the groups of the exploration. +Locate resources **among those currently visible** in the groups of the exploration. - **Scope:** Searches only rendered resources on the canvas. It does *not* query the backend for hidden data. - **Behavior:** Matches are tagged with a (temporary) orange flag and caption. diff --git a/docs/explore-and-author/graph-exploration/graph-insights/features/category-tree.md b/docs/explore-and-author/graph-exploration/graph-insights/features/category-tree.md index 4d4a68e7..82784e43 100644 --- a/docs/explore-and-author/graph-exploration/graph-insights/features/category-tree.md +++ b/docs/explore-and-author/graph-exploration/graph-insights/features/category-tree.md @@ -19,7 +19,14 @@ The tree displays the hierarchical taxonomy of the dataset: - **Hierarchy:** Parent-child relationships (e.g., `Agent` → `Customer`) reflect the underlying schema. - **Counts:** The number in parentheses (e.g., `(132)`) indicates the cardinality of the class. -- **Search:** Filters the tree to locate rapidly a specific class (or saved exploration). + +### Search and View Controls + +- **Search:** Enter text to locate a class or saved exploration. + - *Note:* Initiating a search automatically switches the display into a filtered flat list view and disables the view settings until the search is cleared. +- **View Settings (cogwheel):** When the search bar is empty, click the cogwheel to configure the display: + - **Views:** Switch between `Tree view` (hierarchical) and `List view` (flat). + - **Sorting:** Order the items using `Sort by name` or `Sort by count`. ### Start an Exploration diff --git a/docs/explore-and-author/graph-exploration/graph-insights/features/connections.md b/docs/explore-and-author/graph-exploration/graph-insights/features/connections.md index 927f1a33..7c5da0fe 100644 --- a/docs/explore-and-author/graph-exploration/graph-insights/features/connections.md +++ b/docs/explore-and-author/graph-exploration/graph-insights/features/connections.md @@ -40,7 +40,7 @@ By default, the exploration applies a **left-join pattern**: The left group rema !!! warning "Effects of Subsequent Updates" - Because the switch to an **inner-join pattern** is permanent, any further filtering of the right group will modify the contents of the right group. + Because the switch to an **inner-join pattern** is permanent, any further filtering of the right group will modify the contents of the left group. In the example above, narrowing `Confections | Beverages` to `Beverages` only will remove from the `Supplier` group the ones who do not provide beverages. @@ -57,6 +57,7 @@ By default, the exploration applies a **left-join pattern**: The left group rema Right-click a connection to manage the exploration structure: - **Do not restrict left group:** Disables backpropagation (reverts to left-join). +- **Remove filters:** Clears filters applied via the [connection table](#connection-table). - **Repeat expansion:** Transitively expands the hierarchy (available only for expansions where the left and right groups have the same class - e.g., `is_friend_with`). - **Remove:** Deletes the connection beam and its entire subtree. diff --git a/docs/explore-and-author/graph-exploration/graph-insights/features/groups.md b/docs/explore-and-author/graph-exploration/graph-insights/features/groups.md index c5fa6ad2..82e88254 100644 --- a/docs/explore-and-author/graph-exploration/graph-insights/features/groups.md +++ b/docs/explore-and-author/graph-exploration/graph-insights/features/groups.md @@ -6,7 +6,7 @@ Groups are sets of resources with the same class that are the starting and branc --- -## Group Details +## Group Details {#group-details} Selecting a group opens the **group details** in the right pane. @@ -15,27 +15,35 @@ Selecting a group opens the **group details** in the right pane. The header contains: - The **group caption** that is either: - - The caption of its class if no class filter was applied + - The caption of its class if no class filter was applied - A "logical expression" of class captions describing the combination of class filter applied otherwise (see [histogram filtering](#filtering)) -- A structured **natural language description** of its contents that details all steps of the traversal. +- A structured **natural language description** of its contents that details all steps of the traversal. ### Histogram Sections {#histograms} -The **histogram sections** display the distribution of classes within a group. It allows analysts to scrutinize class composition (eg. spot unexpected or missing classes) and perform logical set operations (union, intersection, difference) to restrict the contents of the groups. +The **histogram sections** display the distribution of classes within a group. It allows analysts to scrutinize class composition (e.g., spot unexpected or missing classes) and perform logical set operations (union, intersection, difference) to restrict the contents of the groups. -- **Scope:** The panel displays counts for all **classes** (including **[user-defined classes](persistence.md#custom-categories)**) present within the selected group. - *Remark: If user-defined classes are present, a second histogram is shown for better overview* -- **Hierarchy:** Use the `(+)` icons to expand a class (e.g., `Confections`) to reveal the distribution of its sub-classes. -- **Sorting:** Use the dropdown to order bars by `Name` (Alphabetical) or `Quantity` (Cardinality). +- **Scope:** The panel displays counts for all **classes** (including **[user-defined classes](persistence.md#custom-categories)**) present within the selected group. + - *Remark:* If user-defined classes are present, a second histogram is shown for better overview ![Histogram Panel Overview](../assets/histograms.png){ class="bordered" width="35%" } +#### Search and View Controls + +The histogram panel includes tools to filter and organize the displayed classes: + +- **Search:** Enter text to filter the visible bars. Use the scope dropdown to target `Captions`, `IRIs`, or `All`. +- **View settings (cogwheel):** + - **Views:** Switch between `Tree view` (respects the class hierarchy, use `(+)` icons to expand) and `List view` (flattens all items). + - **Sorting:** Order the bars using `Sort by name` (alphabetical) or `Sort by count` (cardinality). + - **Hide IRIs:** Toggles the display of the underlying identifiers on the captions. + #### Resources Flagging {#flagging} Flagging highlights specific subsets of data for visual inspection without modifying the structure of the exploration. - **Action:** Select one or more bars in the histogram and click the **Flag** button. -- **Outcome:** Matching resources are tagged with a (temporary) orange flag and caption. +- **Outcome:** Matching resources are tagged with a (temporary) orange flag and caption. *Hint: Use the `Temporary flags` menu that appears on the top left of the canvas to manage the persistence of the temporary flags.* ![Flagged Resources in Group](../assets/histogram-flagged-resources.png){ class="bordered" width="80%" } @@ -74,8 +82,8 @@ As filters are applied, the **group caption** updates to reflect the mathematica The **expansion menu** of a group presents the options available for adding a non-empty step to the traversal. It tells you which classes are reachable via which direction of which object properties. -1. **Action:** Click any group to open the menu. -2. **Select:** The menu presents the hierarchy of connecting (directed) **object properties**, organized by target **class**. +1. **Action:** Point at a group and click the arrow that appears to its right. +2. **Select:** The menu presents the hierarchy of connecting (directed) **object properties**, organized by target **class**. - If the data model includes sub-object properties, point the parent object property to open the sub-menu with its child object property.* 3. **Action:** Click an object property with the required direction for the selected target **class** to add a new connection beam to the exploration. @@ -92,11 +100,23 @@ The **expansion menu** of a group presents the options available for adding a no Right-click a group or its caption to access its context menu. - **Export group resources as CSV:** Downloads a file containing all resources of the group. -- **Copy SPARQL Query:** Copies a query that replicates the traversal up to the group and returns all its resources. -- **Edit note:** Adds a text annotation that will be persisted in [saved explorations](persistence.md#saved-explorations). +- **Copy SPARQL Query:** Copies a query that replicates the traversal up to the group and returns all its resources. +- **Edit note:** Adds a text annotation that will be persisted in [saved explorations](persistence.md#saved-explorations). - **Show resource table:** Opens the tabular view (see the [dedicated page](objects-table.md)). !!! tip "Usage" - The query is intended to be used directly on the database for various datasets with the same model (or slight variations thereof). - Use the notes to explain what is the content of the group in your own words. This is particularly relevant for collaborative work. + + +### Removing Filters {#remove-group-filters} + +You can selectively remove different types of filters applied to a group directly from its context menu. + +- **Action:** Right-click a filtered group to open its context menu and select a removal action: + - `Remove class filters:` Clears set operations applied via the [histograms](#filtering). + - `Remove data property filters:` Clears filters (e.g., numeric, string matches) applied via the [resource table](objects-table.md#filtering). + - `Remove resource selection filters:` Clears filters that restricted the group to specific resources (e.g., via [table row checkboxes](objects-table.md#filter-types) or [restricting to flagged resources](objects.md#restrict-groups-by-flags)). + - `Remove all filters:` Clears all the above filters. +- **Outcome:** The selected filter layer is removed, the group updates, and the exploration tree automatically recalculates to reflect the restored resources. diff --git a/docs/explore-and-author/graph-exploration/graph-insights/features/index.md b/docs/explore-and-author/graph-exploration/graph-insights/features/index.md index d0f65e97..6fab1762 100644 --- a/docs/explore-and-author/graph-exploration/graph-insights/features/index.md +++ b/docs/explore-and-author/graph-exploration/graph-insights/features/index.md @@ -20,4 +20,24 @@ Documentation for the core components of the Graph Insights interface. ## Analysis Tools - **[Histograms](groups.md#histograms):** class distribution analysis and facet-like set operations (union, intersection, difference). -- **[Persistence](persistence.md):** Saved explorations, user-defined classes, and JSON sharing. \ No newline at end of file +- **[Persistence](persistence.md):** Saved explorations, user-defined classes, and JSON sharing. + +--- + +## Global Keyboard Navigation + +Graph Insights supports standard keyboard navigation for accessibility and rapid interaction across all views, including the class tree, data tables, and menus. + +- `TAB` / `SHIFT` + `TAB`: Moves focus to the next or previous interactive element. +- Arrow Keys (`UP`, `DOWN`, `LEFT`, `RIGHT`): Navigates within lists, trees, menus, and subpanels. +- `ENTER`: Triggers the focused element (e.g., a button or menu item) or executes the default action. +- `SPACE`: Toggles a checkbox state or triggers the focused element. +- `ESC`: Closes the currently active temporary element (e.g., popup windows, context menus, or dropdowns). +- `SHIFT` + `ENTER`: Inserts a line break within text input fields (e.g., group notes). + +### Context Menus + +To open a context menu using the keyboard: + +- **Windows:** Press `SHIFT` + `F10`. +- **macOS:** Press `CTRL` + `ENTER` *(Note: Supported in Firefox; Chrome behavior may vary)*. \ No newline at end of file diff --git a/docs/explore-and-author/graph-exploration/graph-insights/features/objects-table.md b/docs/explore-and-author/graph-exploration/graph-insights/features/objects-table.md index a45926fd..d17e9e96 100644 --- a/docs/explore-and-author/graph-exploration/graph-insights/features/objects-table.md +++ b/docs/explore-and-author/graph-exploration/graph-insights/features/objects-table.md @@ -17,7 +17,9 @@ The panel displays a spreadsheet view where rows represent resources and columns ![Group Table Overview](../assets/group-table.png){ class="bordered" width="85%" } -- **Column Visibility:** Click `Columns` to hide/show specific data properties or reorder them via drag-and-drop. +- **Column Visibility:** Click `Columns` to hide/show data properties, or reorder them via drag-and-drop. + - **Sub-class data properties:** The menu includes a dedicated expandable section listing the data properties specific to the sub-classes of the group. + - **Data Property details:** Hover over any item in the list to view its origin classes and datatype. - **Sorting:** Click a column header to sort and toggle the sorting direction. - **Copying Data:** Right-click any cell to copy its value. - **Predecessors:** The `#Predecessors` column displays the count of incoming links from the parent group. Sort this column to identify the most connected resources. @@ -40,11 +42,11 @@ Filtering is a two-step process to prevent unnecessary database queries. ![Filter Status Icons](../assets/filtered-group-and-column.png){ class="bordered" width="85%" } -### Filter Types +### Filter Types {#filter-types} +- **Resource selection column:** Check rows to restrict the group to these resources with the `Restrict to selection` button. - **Numeric/Date:** Range controls (greater than, less than, equals). -- **String:** Text matching (contains, starts with, regex). -- **Resource selection:** Check specific rows to restrict the group to those individual resources. +- **String:** Text matching (contains, starts with, [regex](https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html)). - **Existence:** Filter with `Keep only rows with (non-)empty cells`. ![Numeric Filter Menu](../assets/numeric-filter-nested-menu.png){ class="bordered" width="85%" } diff --git a/docs/explore-and-author/graph-exploration/graph-insights/features/objects.md b/docs/explore-and-author/graph-exploration/graph-insights/features/objects.md index 1a233ad5..7819b56a 100644 --- a/docs/explore-and-author/graph-exploration/graph-insights/features/objects.md +++ b/docs/explore-and-author/graph-exploration/graph-insights/features/objects.md @@ -18,9 +18,19 @@ Select a visible resource in a group or its row in the group table to open the ` 2. **Classes:** List of all classes assigned to the resource. 3. **Data Properties:** List of all data properties organized in sections by their "usage domain" classes (see below). -### Controls -- **Hide empty fields:** Toggles visibility of data properties that have no value for this specific resource. -- **Copy Data:** Right-click any row to copy the **data property** or **data property assertion**. +### Search, View, and Interaction Controls + +Use the search bar and configuration menus at the top of the details pane to quickly locate specific information. + +- **Search scope:** Enter text to filter the pane. Use the adjacent dropdown to target `Captions`, `Values`, `IRIs`, or `All`. + - **Outcome:** Matching rows are highlighted, and section headers display the count of matching data properties aligned to the right. If the scope is set to `IRIs` or `All`, the data properties will additionally display their underlying IRIs. +- **View settings (cogwheel):** + - **Tree view:** Organizes data properties into sections by their defining classes (default behavior). + - **List view:** Flattens the hierarchy, displaying all data properties in a single "All data properties" list. + - **Sort by name:** Sorts the data properties keys alphabetically. + - **Hide empty fields:** Toggles the visibility of data properties that have no value for this specific resource. + - **Hide IRIs:** Toggles the display of the underlying identifiers. +- **Copy data:** Right-click any row to copy the **data property** or **data property assertion**. !!! info "Why are there sections?" @@ -48,8 +58,15 @@ The standard flags are persistent markers used to track the appearance of specif !!! info "About Persistence" - A flag will appear anytime a new instance of the flagged resource is visible in a subsequent exploration step (even in new explorations). - - Flags and notes can be removed using the context-menu of the resource, the group, or the exploration (canvas). + - Flags and notes can be removed using the context-menu of the resource, the group, or the exploration (canvas). + + +#### Restricting Groups by Flags {#restrict-groups-by-flags} + +Once resources are flagged, you can use these visual markers to filter a group down to your items of interest. +- **Action:** Right-click a group containing standard flags to open its context menu and select `Restrict group to flagged resources`. +- **Outcome:** The group is filtered to retain *only* the flagged resources. (Note: Under the hood, this behaves exactly like a manual [resource selection filter](objects-table.md#filter-types) applied via the table and can be cleared using [`Remove resource selection filters`](groups.md#remove-group-filters)). ### Temporary Flags {#temporary-flags} @@ -121,7 +138,7 @@ Analysts can focus on a specific resource within a group to analyze its relation ### Resource Exploration from a Group -Expand the exploration with specific connections from a single resource within a larger group. +Expand the exploration with connections from a single resource within a larger group. - **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). - **Outcome:** A new connection beam connects the individual resource to a new group to its right. @@ -135,7 +152,7 @@ Expand the exploration with specific connections from a single resource within a ### Simple Resource Exploration -Start a new exploration tree with a specific resource found in the current exploration. +Start a new exploration tree with any resource found in the current exploration. - **Action:** Right-click the resource to open its context menu and select `Start exploration with resource`. - **Outcome:** The canvas clears and places the single resource as starting point of the exploration. diff --git a/docs/explore-and-author/graph-exploration/graph-insights/features/persistence.md b/docs/explore-and-author/graph-exploration/graph-insights/features/persistence.md index 7c438e33..37f90406 100644 --- a/docs/explore-and-author/graph-exploration/graph-insights/features/persistence.md +++ b/docs/explore-and-author/graph-exploration/graph-insights/features/persistence.md @@ -42,7 +42,7 @@ If you load and modify a loaded exploration (e.g., add a filter), Graph Insights Add context to the analysis by attaching text notes to important groups. - **Add note:** Right-click a group to open its context menu and select `Add note`. -- **Toggle visibility:** Use the group context menu to toggle the visibility of a single note, or use the context menu of the canvas (or the `Exploration` top menu) and select `Hide/Show all group notes`. +- **Toggle visibility:** Use the group context menu to toggle the visibility of a single note, or use the context menu of the canvas (or the `Exploration` top menu) and select `Hide/Show all group notes`. This default global visibility state is saved locally and persists across browser sessions. ![Saved Exploration Context Menu](../assets/save-exploration-context-menu-and-notes.png){ class="bordered" width="75%" } @@ -55,7 +55,7 @@ Add context to the analysis by attaching text notes to important groups. ## User-Defined Classes {#custom-categories} -**User-defined Graph Insights classes** are customizable tools designed to analyze data with specific goals (e.g. identifying high-risk suppliers based at a given location and having a specific contract type). +**User-defined Graph Insights classes** are customizable tools designed to analyze data with specific goals (e.g., identifying high-risk suppliers based at a given location and having a specific contract type). They act as **"virtual classes"**, refining the model within the exploration layer without altering the underlying ontology. @@ -78,7 +78,7 @@ A user-defined Graph Insights class can be defined for any group in any explorat !!! tip "Hints" - - User-defined classes also appear in an additional specific Graph Insights class histogram for improved visibility (e.g. it allows you to see at first glance how many "High-Risk Suppliers" exist within a larger "Supplier" group). + - User-defined classes also appear in an additional Graph Insights class histogram for improved visibility (e.g., it allows you to see at first glance how many "High-Risk Suppliers" exist within a larger "Supplier" group). - You can create a user-defined class based on *another* user-defined class. diff --git a/docs/explore-and-author/graph-exploration/graph-insights/graph-insights-explore.png b/docs/explore-and-author/graph-exploration/graph-insights/graph-insights-explore.png index b3a764a9..9e0b0ead 100644 Binary files a/docs/explore-and-author/graph-exploration/graph-insights/graph-insights-explore.png and b/docs/explore-and-author/graph-exploration/graph-insights/graph-insights-explore.png differ diff --git a/docs/explore-and-author/graph-exploration/graph-insights/graph-insights-view-in-cmem-classes.png b/docs/explore-and-author/graph-exploration/graph-insights/graph-insights-view-in-cmem-classes.png index 5b0d2152..e85611f8 100644 Binary files a/docs/explore-and-author/graph-exploration/graph-insights/graph-insights-view-in-cmem-classes.png and b/docs/explore-and-author/graph-exploration/graph-insights/graph-insights-view-in-cmem-classes.png differ diff --git a/docs/explore-and-author/graph-exploration/graph-insights/graph-insights-view-in-cmem-resource-details.png b/docs/explore-and-author/graph-exploration/graph-insights/graph-insights-view-in-cmem-resource-details.png new file mode 100644 index 00000000..dc7a49ea Binary files /dev/null and b/docs/explore-and-author/graph-exploration/graph-insights/graph-insights-view-in-cmem-resource-details.png differ diff --git a/docs/explore-and-author/graph-exploration/graph-insights/graph-insights-view-in-cmem-resources.png b/docs/explore-and-author/graph-exploration/graph-insights/graph-insights-view-in-cmem-resources.png index 58bc29cd..556c87d8 100644 Binary files a/docs/explore-and-author/graph-exploration/graph-insights/graph-insights-view-in-cmem-resources.png and b/docs/explore-and-author/graph-exploration/graph-insights/graph-insights-view-in-cmem-resources.png differ diff --git a/docs/explore-and-author/graph-exploration/graph-insights/index.md b/docs/explore-and-author/graph-exploration/graph-insights/index.md index b3d53490..78c2a2c2 100644 --- a/docs/explore-and-author/graph-exploration/graph-insights/index.md +++ b/docs/explore-and-author/graph-exploration/graph-insights/index.md @@ -48,6 +48,7 @@ This task allows for updating snapshots based on the specification of an affecte The **user guide** presents the visual analysis workflow of Graph Insights. It demonstrates how it empowers analysts and domain experts to extract insights from graph data without technical prerequisites. + ### Where to Start? 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"). diff --git a/docs/explore-and-author/graph-exploration/graph-insights/navigating-to-cmem.md b/docs/explore-and-author/graph-exploration/graph-insights/navigating-to-cmem.md index d090e94a..4f25c4ad 100644 --- a/docs/explore-and-author/graph-exploration/graph-insights/navigating-to-cmem.md +++ b/docs/explore-and-author/graph-exploration/graph-insights/navigating-to-cmem.md @@ -28,15 +28,17 @@ If you isolate a specific resource of interest during your exploration, you can There are two ways to trigger this navigation: -**From the Canvas** +### From the Canvas - **Action:** Right-click a specific resource dot within a group to open its context menu. - **Select:** `View in CMEM`. -![View Resource in Corporate Memory from Canvas](graph-insights-view-in-cmem-resources.png){ class="bordered" width="75%" } +![View Resource in Corporate Memory from Canvas](graph-insights-view-in-cmem-resources.png){ class="bordered" width="60%" } -**From the Details Pane** +### From the Details Pane - **Action:** Select a resource on the canvas or in the resource table to load its details in the right pane. -- **Select:** Click the `View in CMEM` button located at the top of the Details pane. +- **Select:** Open the view settings (cogwheel) located at the top-right of the details pane and click `View in CMEM`. - **Outcome:** The specific instance record opens in a new tab. + +![View Resource in Corporate Memory from Details](graph-insights-view-in-cmem-resource-details.png){ class="bordered" width="45%" } diff --git a/docs/explore-and-author/graph-exploration/graph-insights/tutorial.md b/docs/explore-and-author/graph-exploration/graph-insights/tutorial.md index 55988675..768d4631 100644 --- a/docs/explore-and-author/graph-exploration/graph-insights/tutorial.md +++ b/docs/explore-and-author/graph-exploration/graph-insights/tutorial.md @@ -11,23 +11,23 @@ This tutorial demonstrates a workflow of Graph Insights using the **Northwind** !!! info "Demo Data" - The demo data using in this tutorial is available here: [northwind-data.ttl](assets/northwind-data.ttl). + The demo data used in this tutorial is available here: [northwind-data.ttl](assets/northwind-data.ttl). You can import the data: - - by using the web interface (Explore -> Knowledge graphs → Add new graph) or + - by using the web interface (Explore → Knowledge graphs → Add new graph) or - by using the [command line interface](../../../automate/index.md): ```sh cmemc graph import northwind-data.ttl http://example.org/northwind/ ``` - !!! tip "Marketplace Package (preview)" +!!! tip "Marketplace Package (preview)" - The demo data is also available as a _Marketplace Package_ and can be installed with `cmemc`: + The demo data is also available as a _Marketplace Package_ and can be installed with `cmemc`: - ```sh - cmemc package install ecc-northwind-project - ``` + ```sh + cmemc package install ecc-northwind-project + ``` ## Business Scenario @@ -47,7 +47,7 @@ Every exploration requires a starting point. We begin with the central entity: T 2. Drag it to the center of the canvas. 3. **Outcome:** A group appears, representing the entire inventory (e.g., 77 Products). -![Start with Product Category](assets/tutorial-start-with-product.png){ class="bordered" width="80%" } +![Start with Product Category](assets/tutorial-start-with-product.png){ class="bordered" width="65%" } --- @@ -175,4 +175,4 @@ You have successfully modeled a complex dependency network, filtered it by geo-l - **Share:** [Save the exploration](features/persistence.md#saved-explorations) to share this view with colleagues. - **Monitor:** [Create a user-defined class](features/persistence.md#custom-categories) called "High-Risk Confections" to permanently track this segment. -- **Report:** [Export the CSV](features/groups.md#group-operations) of the flagged branch for the procurement team. +- **Report:** [Export the CSV](features/groups.md#group-operations) of the flagged branch for the procurement team. \ No newline at end of file