Jump to: navigation, search

Difference between revisions of "Visualizing and Editing Graphs"

(Step 2. Editing the graph)
(Visualizing and Editing Graphs)
 
(10 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
= Visualizing and Editing Graphs =
 
= Visualizing and Editing Graphs =
  
STEM uses graphs as data structure to save information concerning population sizes, areas, spatial information, neighborhood of areas etc. When you start a scenario, you get the information of its appendent graphs in a visual form, e.g. when you see the outlines of the countries you included into you scenario.  
+
STEM uses graphs as data structure to save information concerning population sizes, areas, spatial information, neighborhood of areas and so on. When you start a scenario, you get information about its appendent graphs in a visual form, e.g. when you see the outlines of the countries you included in your scenario. The Graph Editor allows you to visualize graphs without starting a scenario. You can get a view of the data, edit titles and area sizes, add populations and adjust geographic information of a node. It also makes it possible to create new nodes and edges and to remove existing nodes and edges.
  
The Graph Editor offers the possibility to visualize graphs without starting a scenario. You can get an overview of the data and edit titles, the size of the area, add populations or adjust geographic information of a node.
+
== Step 1. Open the Editor ==
   
+
  
==Step 1. Open the Editor ==
+
When you right-click on an item of the type "Graph" within a project of the STEM Explorer, you will see a context-menu with an item "Display". Clicking on it visualizes the selected graph in the Graph Editor, if the graph contains nodes with spatial information. To visualize all graphs in a certain model, select the item "Display canonical graph" in the model's context menu.
  
When you right-click on an item of the type "Model" within a project of the STEM Explorer, you'll see a context-menu that offers you to display the canonical graph of all graphs that are contained under this model. When you right click on a bottom-level model, you can display the canonical graph of all graphs that lie under this selected model.
+
<gallery widths="300px" heights="300px">
When you right-click on a selected single graph under your models or in the graphs folder, you'll be able to open the graph editor for this graph file.
+
Image:StemOpenGraphEditor.png | Open Graph in Editor
 +
Image:StemOpenGraphEditorModel.png | Open Model in Editor
 +
</gallery>
  
==Step 2. Editing the graph ==
+
== Step 2. Edit the Graph ==
  
The nodes of the graph are small circles, where the color shows the membership to one subgraph, i.e. when you have opened a canonical graph consisting of several countries, the country nodes will have different colors. When you click on a node (provided the graph contains nodes with spatial information, otherwise nothing will be shown in the display) you get information about its title, its URI and all labels that are assigned to this node. You can move the nodes by keeping the left mouse button pressed and drag the node to your desired location.
+
The nodes of the graph are small circles, whose colors show the membership to a subgraph, i.e. when you have opened a canonical graph consisting of several countries, the country nodes will have different colors. When you click on a node, you get information about its title, its URI and all labels that are assigned to this node. Several of these values are editable. You can move a node by keeping the left mouse button pressed and dragging the node to the desired location. To add a label to a node (e.g. add information about population size or area of the node), remove a label or remove the node itself you have to right-click on the node and a context menu shows up. The parameters of a newly added label can be edited in the bottom part of the editor.
When you want to add a label to a node (e.g. add information about population size or area of the node) you must select one node by left-clicking on it and open the context menu with a right click. You can then add a population or area label and edit the values in the bottom part of the editor.
+
  
Edges can also be selected. Information about the class of edge and potential edge values are shown in the bottom part of the display.
+
<gallery widths="600px" heights="300px">
 +
Image:StemGraphEditorAddLabel.png | Node Context Menu
 +
</gallery>
 +
 
 +
If you right-click in the graph, when no nodes and edges are selected, a context menu appears. This allows you to create a new node at the location, where you have right-clicked. The polygon of a newly created node is a rectangle, whose side length has to be specified in a dialog.
 +
 
 +
<gallery widths="600px" heights="300px">
 +
Image:StemGraphEditorAddNode.png | Add Node Context Menu
 +
</gallery>
 +
 
 +
Edges can also be selected to display their properties (type of the edge, ...). Some of the properties can also be edited. Right-clicking on an edge shows a context menu that allows removing this edge.
 +
 
 +
<gallery widths="600px" heights="300px">
 +
Image:StemGraphEditorRemoveEdge.png | Edge Context Menu
 +
</gallery>
 +
 
 +
To add an edge between two nodes, select the origin node. While holding the Ctrl key, right-click on the destination node to open the context menu. Different types of edges can be created.
 +
 
 +
<gallery widths="600px" heights="300px">
 +
Image:StemGraphEditorAddEdge.png | Add Edge Context Menu
 +
</gallery>
  
 
You can zoom in and out with the mouse wheel.
 
You can zoom in and out with the mouse wheel.
  
==Step 3. Saving the graph ==
+
== Step 3. Save the Graph ==
  
When you want to save the edits you have made, you can select "Save" (and the changes are saved into the same files) or you select "Save As" where you have to select a folder and filename.  
+
To save an edited graph, you can select "Save Graph and Quit" (the changes are saved into the same files) or you select "Save Graph As" where you have to select a folder and filename. When you are working on references to graphs in the STEM graph/model repository, local copies of the references including your changes will be saved to the workspace. If you were working on local copies already, your files will be overwritten when "Save Graph" is selected.
When you were working on a reference to graphs in the STEM graph/model repository, local copies of the references including your changes will be saved to your workspace. If you were working on local copies already, your files will be overwritten, when you select "Save Graph".
+

Latest revision as of 20:10, 4 April 2012

Visualizing and Editing Graphs

STEM uses graphs as data structure to save information concerning population sizes, areas, spatial information, neighborhood of areas and so on. When you start a scenario, you get information about its appendent graphs in a visual form, e.g. when you see the outlines of the countries you included in your scenario. The Graph Editor allows you to visualize graphs without starting a scenario. You can get a view of the data, edit titles and area sizes, add populations and adjust geographic information of a node. It also makes it possible to create new nodes and edges and to remove existing nodes and edges.

Step 1. Open the Editor

When you right-click on an item of the type "Graph" within a project of the STEM Explorer, you will see a context-menu with an item "Display". Clicking on it visualizes the selected graph in the Graph Editor, if the graph contains nodes with spatial information. To visualize all graphs in a certain model, select the item "Display canonical graph" in the model's context menu.

Step 2. Edit the Graph

The nodes of the graph are small circles, whose colors show the membership to a subgraph, i.e. when you have opened a canonical graph consisting of several countries, the country nodes will have different colors. When you click on a node, you get information about its title, its URI and all labels that are assigned to this node. Several of these values are editable. You can move a node by keeping the left mouse button pressed and dragging the node to the desired location. To add a label to a node (e.g. add information about population size or area of the node), remove a label or remove the node itself you have to right-click on the node and a context menu shows up. The parameters of a newly added label can be edited in the bottom part of the editor.

If you right-click in the graph, when no nodes and edges are selected, a context menu appears. This allows you to create a new node at the location, where you have right-clicked. The polygon of a newly created node is a rectangle, whose side length has to be specified in a dialog.

Edges can also be selected to display their properties (type of the edge, ...). Some of the properties can also be edited. Right-clicking on an edge shows a context menu that allows removing this edge.

To add an edge between two nodes, select the origin node. While holding the Ctrl key, right-click on the destination node to open the context menu. Different types of edges can be created.

You can zoom in and out with the mouse wheel.

Step 3. Save the Graph

To save an edited graph, you can select "Save Graph and Quit" (the changes are saved into the same files) or you select "Save Graph As" where you have to select a folder and filename. When you are working on references to graphs in the STEM graph/model repository, local copies of the references including your changes will be saved to the workspace. If you were working on local copies already, your files will be overwritten when "Save Graph" is selected.