Skip to main content
Jump to: navigation, search

Difference between revisions of "Using VIBE with ICE"

(Using ICE to run VIBE (Virtual Integrated Battery Environment) simulations)
 
(17 intermediate revisions by the same user not shown)
Line 1: Line 1:
=== Using ICE to run VIBE (Virtual Integrated Battery Environment) simulations ===
+
== Introduction ==
  
ICE provides three items that can be used to configure and run VIBE simulations:
+
ICE provides three items that can be used to configure and run Virtual Integrated Battery Environment (VIBE) simulations:
 
*'''VIBE Key-Value Pair''' – Allows the user to specify variable values in a simulation. This item is optional.
 
*'''VIBE Key-Value Pair''' – Allows the user to specify variable values in a simulation. This item is optional.
 
*'''VIBE Launcher''' – Runs the specified simulation.
 
*'''VIBE Launcher''' – Runs the specified simulation.
 
*'''VIBE Model''' – Allows the user to configure the simulation setup parameters.
 
*'''VIBE Model''' – Allows the user to configure the simulation setup parameters.
  
To select one of these items from the list of available plugins in ICE, click the ''Create an Item'' button (stylized as a '+') in the "Item Viewer" view pane/tab.
+
 
 +
== Creating a VIBE Model ==
 +
 
 +
To select one of these items from the list of available plugins in ICE, click the ''Create an Item'' button (stylized as a "+") in the "Item Viewer" view pane/tab.
  
 
[[File:Create_an_item.png]]
 
[[File:Create_an_item.png]]
  
This will present the user with a dialog that lists available ICE plugins (including three VIBE-related items), as show below.
+
This will present the user with a dialog that lists available ICE plugins (including three VIBE-related items), as shown below.
  
 
[[File:Vibe_model.png]]
 
[[File:Vibe_model.png]]
  
 
To start, the user should select the ''VIBE Model'' item and click ''Finish''. This will open the "VIBE Model" form.
 
To start, the user should select the ''VIBE Model'' item and click ''Finish''. This will open the "VIBE Model" form.
 
 
==== Creating a VIBE Model ====
 
  
 
In this initial example, the "VIBE Model" form (pictured below) will be populated with the information for the default "VIBE Model" case, which is suitable for this tutorial.
 
In this initial example, the "VIBE Model" form (pictured below) will be populated with the information for the default "VIBE Model" case, which is suitable for this tutorial.
Line 25: Line 25:
 
[[File:Vibe_Model_1.png]]
 
[[File:Vibe_Model_1.png]]
  
The "VIBE Model" form should be exported to a VIBE readable file using the combo box in the upper right hand corner.
+
Select ''Export to VIBE INI format'' from the combo box, and click ''Go!'' to write the input file.
 
+
Select ''Export to VIBE INI Format'' from the dropdown menu and click ''GO!'' to write the input file.
+
  
 
[[File:ICE_VIBE_process_select_stc.png]]
 
[[File:ICE_VIBE_process_select_stc.png]]
  
  
==== Creating a VIBE Launcher ====
+
== Creating a VIBE Launcher ==
  
 
The next step is to add the "VIBE Launcher" item to the workflow.
 
The next step is to add the "VIBE Launcher" item to the workflow.
  
Just as before, click the ''Create an Item'' button (stylized as a '+') in the "Item Viewer" view pane/tab.
+
Just as before, click the ''Create an Item'' button (stylized as a "+") in the "Item Viewer" view pane/tab.
  
[[File:Create_an_item.png]]
+
[[File:ICE_create_item_stc_2.png]]
 
+
This will present the user with a dialog that lists available ICE plugins (including three VIBE-related items), as show below.
+
  
 
This time select ''VIBE Launcher'' from the list and click ''Finish''. This will open the "VIBE Launcher" form.
 
This time select ''VIBE Launcher'' from the list and click ''Finish''. This will open the "VIBE Launcher" form.
Line 55: Line 51:
  
  
==== Run the Simulation ====
+
== Running the Simulation ==
To run the simulation save the item (''File'' > ''Save'') and then click ''Go!''
+
To run the simulation, save the item (''File'' > ''Save'') and then click ''Go!''
  
 
[[File:ICE_VIBE_launcher_GO_stc.png]]
 
[[File:ICE_VIBE_launcher_GO_stc.png]]
  
The VIBE Model item can be created inside of the existing project. Simply right click on that project in your Project Explorer window and choose New -> Other -> Create Item Wizard, then hit the 'Next' button and select 'VIBE Model' from the list of all of the available plugins.  
+
 
 +
== Adding VIBE to an Existing Project ==
 +
 
 +
VIBE items can also be created within an existing project.
 +
 
 +
In the "Project Explorer" view pane, right click on the project and choose ''New'' > ''Other''. This action will prompt the "Select a Wizard" dialog.
  
 
[[File:New_other.png]]
 
[[File:New_other.png]]
  
'''Fig 5.''' Right-click on the existing project to add an item
+
From the "Select a Wizard" dialog, select ''Create Item Wizard'' and click ''Next''.
  
 
[[File:Create_item_wiz.png]]
 
[[File:Create_item_wiz.png]]
  
'''Fig 6.''' Choose 'Create Item Wizard'
+
Next, select ''VIBE Model'' and click ''Finish''.
  
[[File:Vibe_model_added.png]]
+
[[File:ICE_VIBE_item-selector_stc.png]]
  
'''Fig 7.'''The VIBE Model item is now added to your project
+
The VIBE Model is now visible in the "Project" view pane.
 +
 
 +
[[File:Vibe_model_added.png]]
  
Similarly,the other VIBE items can be added in order to run the simulation.
+
Other VIBE items can be added to a project by going through the steps outlined above. The user can also execute their simulations from within their project.

Latest revision as of 14:14, 28 November 2016

Introduction

ICE provides three items that can be used to configure and run Virtual Integrated Battery Environment (VIBE) simulations:

  • VIBE Key-Value Pair – Allows the user to specify variable values in a simulation. This item is optional.
  • VIBE Launcher – Runs the specified simulation.
  • VIBE Model – Allows the user to configure the simulation setup parameters.


Creating a VIBE Model

To select one of these items from the list of available plugins in ICE, click the Create an Item button (stylized as a "+") in the "Item Viewer" view pane/tab.

Create an item.png

This will present the user with a dialog that lists available ICE plugins (including three VIBE-related items), as shown below.

Vibe model.png

To start, the user should select the VIBE Model item and click Finish. This will open the "VIBE Model" form.

In this initial example, the "VIBE Model" form (pictured below) will be populated with the information for the default "VIBE Model" case, which is suitable for this tutorial.

Advanced users can customize the variables in this form to suit their use case.

Vibe Model 1.png

Select Export to VIBE INI format from the combo box, and click Go! to write the input file.

ICE VIBE process select stc.png


Creating a VIBE Launcher

The next step is to add the "VIBE Launcher" item to the workflow.

Just as before, click the Create an Item button (stylized as a "+") in the "Item Viewer" view pane/tab.

ICE create item stc 2.png

This time select VIBE Launcher from the list and click Finish. This will open the "VIBE Launcher" form.

ICE VIBE launcher stc.png

The "VIBE Launcher" form (pictured below) will be populated with the information for the default "VIBE Launcher" case, which is suitable for this tutorial.

Vibe Launcher conf.png

The "VIBE Model" form's output should have resulted in a *.conf input file that should be saved in the default ICE development directory—the input file is called VIBE_Model_1.conf in this case.

To locate the input file, the user can select Browse... if the file is not automatically populated in the "Input File" combo box, as pictured above.


Running the Simulation

To run the simulation, save the item (File > Save) and then click Go!

ICE VIBE launcher GO stc.png


Adding VIBE to an Existing Project

VIBE items can also be created within an existing project.

In the "Project Explorer" view pane, right click on the project and choose New > Other. This action will prompt the "Select a Wizard" dialog.

New other.png

From the "Select a Wizard" dialog, select Create Item Wizard and click Next.

Create item wiz.png

Next, select VIBE Model and click Finish.

ICE VIBE item-selector stc.png

The VIBE Model is now visible in the "Project" view pane.

Vibe model added.png

Other VIBE items can be added to a project by going through the steps outlined above. The user can also execute their simulations from within their project.

Back to the top