A Project is an overall container for all the other types of objects that make up a network simulation. A Project is a set of named Containers or collections, each of which holds objects of a specific type. Most of the containers enable you to create your own objects of that type, but some are prepackaged with a fixed set of items. The collections are explained in detail below.
The Project_window provides the main user interface for the project.
You should immediately give the project a descriptive name, and then save it to a file:
- in the main menu or toolbar of the project, select File/Save As
- specify a file name, and press Ok
Recover Files (projects)
In an ideal world, software would never crash, unfortunately, in the real world, it sometimes does. You can help prevent loss of work by saving often - use File/Save or the toolbar button. In addition, emergent can detect most crashes and will automatically save the project in its current state to a separate recover file - the file will have the same base name as your project, with an added number; it is stored in the same folder as your project. When emergent starts, it will (in most cases) automatically detect that a crash occurred last time, and put the name of the recover file at the top of the File/Recent selections.
IMPORTANT: if you open a recover file, remember this is a separate project - if you want to accept the state of the project as it is in the recover file, you will need to re-save it over top of your previous project. You may want to make a copy of your main project file before overwriting it with the recover file.
Working with projects
Emergent keeps track of your most recently saved or opened projects - you can reopen a project from File/Recent.
Creating objects in containers
- right click on the collection, ex. 'docs'
- from the menu, select New
- in the dialog, specify the exact type of the object you want (in many cases, there is only one choice)
- specify how many objects you want to create (often 1)
- click Ok
the new object is added to the collection
You may wish to give the object a descriptive name before proceeding.
- select the object in the tree view (if it is not already selected)
- in the edit panel, select the Properties view (if not already selected)
- edit the name of the object
- press Apply
You can delete any object:
- select the object in the tree view
- right click, and select Delete from the menu
if Delete is not available, the object may not be deleted (ex. Wizards, etc.)
Copying an object
Sometimes you want to make a new object that is similar to an existing object. In this case, it is easier and faster to copy the object and then customize the new object.
To duplicate an object:
- select the object (or objects) you wish to duplicate
- right click, and select Duplicate from the menu (note that the new object(s) is given a default name)
- select the new object and give it a descriptive name
- make any other changes necessary to the new object
You can also copy/paste objects to duplicate them - this can be helpful when you want the new object in a different collection than the existing object.
To copy an object:
- select the object (or objects) you wish to copy
- right click, and select Copy from the menu
- navigate to the collection where you wish to place the copy (or copies)
- to paste at the end, click on the collection; to insert, click on the object where you would like the new object to be placed
- right click, and select Paste Into (when appending at the end of the collection) or Paste Here (when inserting inside the collection on an item)
Many of the collections support Groups, which are similar to subfolders inside the main folder. Unless mentioned otherwise, there is no particular significance to groups, apart from helping you better organize objects, particularly in larger Containers.
To create a subgroup:
- select the collection (group) in which you want the new subgroup
- right click, and select New Group from the menu
- in the dialog, specify the number of subgroups (usually 1)
- specify the exact type (the indicated default is usually correct)
- press Ok
As for all new objects, it is generally a good idea to give the new subgroup a descriptive name.
Follow the links for detailed descriptions of the object types.
- docs - a Doc object is a web-like document that can be used to document a model, provide instructions on operating it, and so on
- wizards - a Wizard provides automated assistance in creating other objects, such as complete network simulations (note: you will never create these)
- edits - a ControlPanel provides a way to gather properties from many other objects, to set them in one place - for example, you can collect various network parameters all in one place, to easily set them
- data - holds datatables - the system automatically provides several subgroups to help organize your data, you can also add new subgroups of your own
- data proc - holds pre-built DataProc objects - similar to Wizards, these provide various data services that operate on data (note: you will never create these)
- programs - a Program controls network simulations, data processing, and other automated procedures - when you use a wizard to create a simulation, it automatically imports the required standard programs from the program library
- viewers - holds 3D Viewer objects - every project gets a Default Viewer, which is created when the project is created, and opened automatically when the project is opened - you can also create additional viewers - you might want to do this for larger projects, to include lesser-used graphs or other 3D views - to open auxiliary views, right click the view and select View Window
- networks - most network simulations use a single network, but you can create more than one, such as for example to experiment with different configurations
Converting a PDP++ Project
See PDP++ Project Conversion for detailed information on this process.