Libraries, Projects & Scenarios: Overview
All of the of inputs and outputs associated with a Package's model are stored in a single file (with an extension of .ssim). This file is referred to as a SyncroSim Library.
When a Library is first created (using the New Library option on the File menu), SyncroSim automatically creates the database schema (in SQLite format) required to store all the inputs and outputs required by the Package in the Library file. The inputs and outputs of a Library are organized into Datafeeds. Most often each Datafeed consists of a single table of data (called a Datasheet), although there are times when it makes sense to combine several Datasheets into one Datafeed.
SyncroSim also allows users to (optionally) subdivide their Library into Projects. Projects, in turn, can contain any number of Scenarios. New Projects can be created using the New Project option on the Edit menu, while Scenarios can be created using the New Scenario option on the Scenario menu.
To illustrate this concept, in the example shown above we show two hypothetical Libraries in the SyncroSim Library Explorer: Library A and Library B. We have further divided Library A into two Projects: Project A-1 and Project A-2. Each Project, in turn, contains a number of Scenarios.
Every Project and Scenario is automatically assigned a unique ID when it is first created. The ID value for each Scenario is displayed in square brackets before the Scenario name in the Library Explorer, while the ID value for each Project is shown on the Project's Summary Property,
All of the data associated with a particular library are organized into Datafeeds. There are three types of Datafeeds:
- Library Datafeeds contain data that is specified only once for the entire Library. These are typically global settings for your model.
- Project Datafeeds contain data specified only once for each Project. These are typically definitions for a model - i.e. values that must be consistent across Scenarios in order for the results of multiple Scenario runs to be meaningfully compared.
- Scenario Datafeeds contain data that are specified once for each Scenario, including both model inputs and outputs.
By default an empty Library always starts with a single Project named Definitions and a single Scenario named New Scenario.
To help keep your Library organized, both Projects and Scenarios can be further organized into nested Folders in the Library Explorer using the New Folder... option on the Edit menu.