|
| 1 | += 3D Graph |
| 2 | + |
| 3 | +link:../../extensions/advanced-visualizations[label:Advanced Visualization[]] |
| 4 | + |
| 5 | +The 3D graph report extends the default graph visualization with another dimension. |
| 6 | +It supports most of the features & customizations for the regular (2D) graph, including rule-based styling and report actions. |
| 7 | +Users can explore the 3D graph by zooming and panning through 3D space. |
| 8 | + |
| 9 | + |
| 10 | +== Examples |
| 11 | + |
| 12 | +=== Basic Graph |
| 13 | + |
| 14 | +.... |
| 15 | +MATCH (p:Person)-[a:ACTED_IN]->(m:Movie) |
| 16 | +WHERE m.title = 'The Matrix' |
| 17 | +RETURN p, a, m |
| 18 | +.... |
| 19 | + |
| 20 | +image::graph3d.png[Basic 3D Graph] |
| 21 | + |
| 22 | +== Virtual Graph |
| 23 | + |
| 24 | +.... |
| 25 | +MATCH (p:Person)-[:ACTED_IN]->(m:Movie)<-[:ACTED_IN]-(p2:Person) |
| 26 | +WHERE m.title = "The Matrix" |
| 27 | +RETURN p, p2, apoc.create.vRelationship(p, "KNOWS", {}, p2) |
| 28 | +.... |
| 29 | + |
| 30 | +image::graph3dvirtual.png[Virtual 3D Graph] |
| 31 | + |
| 32 | +== Advanced Settings |
| 33 | + |
| 34 | +[width="100%",cols="12%,2%,3%,83%",options="header",] |
| 35 | +|=== |
| 36 | +|Name |Type |Default Value |Description |
| 37 | +|Node Color Scheme |List |neodash |The color scheme to use for the node |
| 38 | +labels. Colors are assigned automatically (consequitevely) to the |
| 39 | +different labels returned by the Cypher query. |
| 40 | + |
| 41 | +|Node Label Color |Text |black |The color of the labels drawn on the |
| 42 | +nodes. |
| 43 | + |
| 44 | +|Node Label Font Size |Number |3.5 |Size of the labels drawn on the |
| 45 | +nodes. |
| 46 | + |
| 47 | +|Node Size |Number |2 |Default size of a node in the graph |
| 48 | +visualization. This size is applied if no custom size styling is defined |
| 49 | +and no Rule-Based styling is active. |
| 50 | + |
| 51 | +|Node Size Property |Text |size |Optionally, the name of the node |
| 52 | +property to map to the node size. This lets you define sizes on a |
| 53 | +node-specific level, if you have a property that directly maps to the |
| 54 | +numeric size value. |
| 55 | + |
| 56 | +|Node Color Property |Text |color |Optionally, the name of the node |
| 57 | +property to map to the node color. This lets you define colors on a |
| 58 | +node-specific level, if you have a property that directly maps to the |
| 59 | +HTML color value. |
| 60 | + |
| 61 | +|Relationship Color |Text |#a0a0a0 |The color used for drawing the |
| 62 | +relationship arrows in the visualization. |
| 63 | + |
| 64 | +|Relationship Width |Text |1 |The (default) width of the relationship |
| 65 | +arrows in the visualization. |
| 66 | + |
| 67 | +|Relationship Label Color |Text |#a0a0a0 |The color of the labels |
| 68 | +(relationship type) drawn next to the relationship arrows. |
| 69 | + |
| 70 | +|Relationship Label Font Size |Text |2.75 |The font size of the labels |
| 71 | +(relationship type) drawn next to the relationship arrows. |
| 72 | + |
| 73 | +|Relationship Color Property |Text |color |Optionally, the name of the |
| 74 | +relationship property to map to the arrow color. This lets you define |
| 75 | +colors on a relationship-specific level, if you have a property that |
| 76 | +directly maps to the HTML color value. |
| 77 | + |
| 78 | +|Relationship Width Property |Text |width |Optionally, the name of the |
| 79 | +relationship property to map to the arrow width. This lets you define |
| 80 | +widths on a relationship-specific level, if you have a property that |
| 81 | +directly maps to the width value. |
| 82 | + |
| 83 | +|Animated Particles on Relationships |on/off |off |If enabled, draw |
| 84 | +relationships with animated particles on them, moving in the direction |
| 85 | +of the relationship. |
| 86 | + |
| 87 | +|Arrow head size |Number |3 |Use this to set the length of the arrow head, size is adjusted automatically. |
| 88 | +If 0, no arrow will be drawn. |
| 89 | + |
| 90 | +|Background Color |Text |#fafafa |The background color of the |
| 91 | +visualization. |
| 92 | + |
| 93 | +|Layout (experimental) |List |force-directed |tree-top-down |tree-bottom-up |tree-left-right |tree-right-left |radial | Use this to switch from |
| 94 | +the main (force-directed) layout to one of the experimental layouts |
| 95 | +(tree, radial). For the experimental layouts, make sure |
| 96 | +your graph is a DAG (directed acyclic graph). |
| 97 | + |
| 98 | +| Graph Depth Separation | Number | 30 | Specify the level distance for the tree layout. |
| 99 | +This setting controls the separation between different levels in the tree hierarchy. Adjusting this value impacts the overall spacing of the tree layout in your graph visualization. |
| 100 | + |
| 101 | +|Enable graph exploration |on/off |on |Enables basic exploration functionality for the graph. Exploration can be done by right clicking on a node, and choosing 'Expand' to choose a type to traverse. Data is retrieved real-time and not cached in the visualization. |
| 102 | + |
| 103 | +|Enable graph editing |on/off |off |Enables editing of nodes and relationships in the graph from the right-click context menu. In addition, lets users create new relationships with existing types/property keys as present in the database. |
| 104 | + |
| 105 | +|Show pop-up on Hover |on/off |on |if enabled, shows a pop-up when a |
| 106 | +user hovers over one of the nodes/relationships in the visualization. |
| 107 | +The pop-up contains the label and properties of the node/relationship. |
| 108 | + |
| 109 | +|Show properties on Click |on/off |on |if enabled, opens up a window |
| 110 | +when a user clicks on one of the nodes/relationships in the |
| 111 | +visualization. The window contains the label and properties of the |
| 112 | +node/relationship. |
| 113 | + |
| 114 | +|Drilldown Link |Text (URL) |(no value) |Specifying a URL here will |
| 115 | +display a floating button on the top right of the visualization. This |
| 116 | +button can be used to drilldown into a different tool (e.g. Bloom) so |
| 117 | +that the graph can be explored further. Dynamic Dashboard Parameters |
| 118 | +(e.g. $neodash_person_name) can be used in these links as well. |
| 119 | + |
| 120 | +|Hide Selections |on/off |off |If enabled, hides the property selector |
| 121 | +(footer of the visualization). |
| 122 | + |
| 123 | +|Override no data message |Text |Query returned no data. |Override the message displayed to the user when their query returns no data. |
| 124 | + |
| 125 | +|Auto-run query |on/off |on |when activated automatically runs the query |
| 126 | +when the report is displayed. When set to `off', the query is displayed |
| 127 | +and will need to be executed manually. |
| 128 | +|Report Description |markdown text | | When specified, adds another button the report header that opens a pop-up. This pop-up contains the rendered markdown from this setting. |
| 129 | +|=== |
| 130 | + |
| 131 | +== Rule-Based Styling |
| 132 | + |
| 133 | +Using the link:../#_rule_based_styling[Rule-Based Styling] menu, the |
| 134 | +following style rules can be applied to the graph: |
| 135 | + |
| 136 | +- The background color of a node. |
| 137 | +- The label color of a node. |
0 commit comments