Getting started with CPN Tools | CPN Tools help |
How to get started using CPN Tools | How-to |
This page explains some of the basic steps to using CPN Tools. If you've never used CPN Tools before, this is a good place to begin. On the main help page, you can find more detailed information about the various aspects of the tool.
If you have problems starting up the tool or installing it, read the hardware requirements page, or report your problems to our technical support.
If you do not see this, but in stead a gray or green windows or nothing at all, the problem may be your graphics adaptor. Please check the FAQ for further details.
Each of the cursors is controlled with its own separate input device, such as a mouse, a pen, or a trackball. Multiple cursors can be controlled by one or more users at the same time. In the following, we will assume that you use a mouse in your right hand as your primary input device, and write "the hand", "the mouse", "the cursor", etc. for this. The interactions are, however, just the same for the left hand and/or another two-button input device.
To get started working on a CP-net, you can either load an existing net or create a new one.
To load an existing net, move the cursor to the workspace or to an empty part of the index. Press with the right button of the mouse and keep the button pressed. A circular menu appears - this is the workspace marking menu. (Read more about these menus on the Marking menus page).
Keep the button pressed and move the cursor to the Load Net entry in the menu. The entries will highlight when the cursor moves over them - release the button when the Load Net entry is highlighted.
A file dialog appears from which you can select the net you wish to load. When you have selected a net and clicked OK, the dialog disappears, and the net appears in the index at the left side in the CPN Tools window. After a net has been loaded, the name of the net appears as an entry in the index.
Alternatively, you can create a new net by bringing up the workspace marking menu and selecting the New Net entry.
Remember to keep the right button pressed as you move the cursor around in the marking menus. If you release the button when no entry is highlighted, the menu disappears and no command is invoked. Press down the right button to bring the menu up again.
The index is located in the left side of the CPN Tools window:
The index contains:
The index contains an entry for each net that is opened in the tool. If the net was loaded from a file, then the net entry in the index is labelled with the name of the net. In the figure below, the net named "hier.cpn" has been loaded. If a new net was created, the net entry is labelled "New net.cpn".
To start working on a page in the net, the net entry in the index must be opened. Click on the triangle next to the name to open the entry, if it is not already opened.
A net entry contains:
All pages in a net are accessible through the index. The hierarchical structure of a net is reflected in the index. The entry for a subpage appears under the entry for its superpage. Subpage entries are visible in the index when the corresponding superpage entry has been opened.
Opening the entry for the "Top" page shows that it has four subpages: one instance of the "Sender" and "Network" pages, and two instances of the "Receiver" page.
If you have created a new net instead of loading one, there will be only one page, called New Page. This page is created automatically with the new net, and is empty so you can start creating net objects on it.
To open a page in the net, move the cursor over the name of the page, press down the left mouse button and drag the page name to the workspace. Here the page named "Top" is being dragged to the workspace. If you have a new net, drag the page "New Page" to the workspace to start creating a net.
Release the mouse button. The page now appears on the workspace in a binder.
If you have dragged the empty page out, you probably want to start creating objects etc. See the Edit the net page for more information.
The pages can be dragged from the index to the workspace and dropped in one or more binders. To drop a page in a binder, release the mouse button when the page name is inside the visible area at the top of the binder.
To drop it in a new binder, drop the name outside of the binder area.
You can place several pages in the same binder, and you can have the same page in more than one binder. A binder can only contain pages from one net.
To move a page from one binder to another, press with the left mouse button on the page tab at the top left corner of the page and drag the page to an existing binder. You can also put it in a new binder by releasing the page somewhere on the workspace in the same way as when dragging from the index.
The position of the binders are saved when you save a model.
Tools for creating new CP-net elements, simulating nets, changing line colors and line widths, etc., are accessible from tool palettes in the tool box in the index and through marking menus on the various objects in the workspace.
To access a tool palette in the index, open the Tool Box entry in the index.
Drag a palette to the workspace the same way as you drag a page: Move the cursor over the name, press the left button, drag the name to the workspace, and release. Like pages, tool palettes can be placed in binders together or separately.
Read more about how palettes work, or read about the palettes available in CPN Tools.
To access a tool in a marking menu, press down the right mouse button over an object and choose the command you wish to perform. The marking menus are context-sensitive, i.e. their contents change depending on where you bring them up. If you, e.g., press down the right mouse button in an empty area on a page, a menu will appear with commands for creating new CP-net elements: places and transitions.
Read more about how marking menus work, or read about the marking menu tools available in CPN Tools.
For more information about the Help pages, see the help page for Help entry in index.