Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Bug 206405

Summary: Building a scenario appears to work but disease does not spread
Product: [Technology] STEM Reporter: John Thomas <jthomas119>
Component: InternalAssignee: John Thomas <jthomas119>
Status: CLOSED FIXED QA Contact: Daniel Ford <webdaford>
Severity: normal    
Priority: P3    
Version: unspecified   
Target Milestone: ---   
Hardware: All   
OS: Windows XP   
Whiteboard:
Bug Depends on: 206459    
Bug Blocks:    
Attachments:
Description Flags
New Project tutorial webdaford: iplog+

Description John Thomas CLA 2007-10-15 21:01:23 EDT
The instructions below are a modified version of Jamie's perculation instructions but they use an existing disease implementation.  
The resulting scenario runs with no error but no disease appears on the map.  

I suspect that the problem is in the specification of the Infector.  

I have tried with both Cuba which is Level 0 only and Japan Level 2.  With a Level 2 (or 1 ) admin area, it is not clear how the user would code the Infector without intimate knowledge of the Admin area names.  

Once this is fixed or the error in the instructions corrected, I volunteer to put the corrected instruction into the Help text and/or Wiki

John
--------------------------------------------------------------------

Modified version of Jamie's instruction for Perculation.


The Names for Project and other NAMES that I used to create the Test project are in parentheses. 
Substitute your names as appropriate. In this example, the scenario will be for Japan.

Note: There are icons for many of the actions but for clarity I use 
the menubar items. 


Creating the Project
1) Click on New->STEM project and create new STEM project (Test)
2) Open the new project – you should see several folders including: decorators, graphs, etc.

Creating a new Model
3) Click on New->Model to create new model (TestModel)
4) Fill in any Dublin core data you want to add

Adding a Disease to the Model
5)On the menu bar click New>New Disease
6) Fill in the Name: (TestDiseaseName)
7) Fill in the Disease Name: (TestDiseaseName)
8) Select the DiseaseModel in the ComboBox: 
   e.g., select  "DeterministicSEIRDiseaseModelImpl"
9) Fill in any Dublin core data you want to add
10) Click finish
11) Under decorators you should see TestDisease.standard
12)Double click on MODELS in the project explorer. You should see TestModel in the Resource Set.
13) DRAG your new disease (e.g., TestDisease.Standard) from decorators (in the project explorer window)  into the model "TestModel" in the Rescource Set window. Expand the "TestModel" in the Resource Set window to see that it worked.

Adding the Geographical data to the Model
14) To add the geography data for Japan, at the bottom panel under Models, click on >STEM>Geography>Political>Country>JPN(2) full infrastructure
15) Drag this up to the Model "TestModel" in the Resource set window

save your work at this point by hitting <ctrl>S

Create a Scenario and add your model to it
16) click on New->Scenario to create new scenario
17) give it a name (TestScenario))
18) Fill in any Dublin core data you want to add
19) click finish
20) From the Project Explorer window, under Models, Drag the new model (TestModel) into the new Scenario in the Resource Set. Expand the scenario so you can see that it worked.

Add a sequencer to the Scenario
21) Go to Sequencers on the bottom window - expand fully
22) drag Sequential Sequencer 2006 into the Scenario in the Resource Set

Make sure you have a properties Editor Window open
23) click on >Window>other>General>Properties to open the properties view

Open the Disease in the Properties Editor – get ready to Create an Infector
24) To create an infector you first need to make sure you know the
exact ‘Disease Name’ used in step 7 above. To be sure ot check it 

Creating and adding an Infector
26) Click on New->New Infector 
27) Name it (TestInfector), under DiseaseName: "TestDiseaseName"
28) Under ISO Target specify  JP-KNT-G230006
29) Click on the Scenrio to open it in the Resource set
30) drag the TestInfector from Decorators into the scenario (open it to see it)

Step 28 is a potential problem.  I put this in becase this is the 
node used in the prebuilt Japan Scenario.  How would a normal user 
figure out what goes here?

save your work at this point by hitting <ctrl>S

31) click on the scenario, right click and run >
Comment 1 Daniel Ford CLA 2007-10-16 09:34:50 EDT
Step 14  >STEM>Geography>Political>Country>JPN(2)  should use "JPN(0,1,2) Full infrastructure" instead of "JPN(2)".  The later only has the Nodes and so is missing the connections between the Nodes through which the disease can travel.

I did notice that the Infector Wizard wasn't working correctly.  I opened bug https://bugs.eclipse.org/bugs/show_bug.cgi?id=206459 for that.  When it works correctly, the names of the different regions of a country are displayed so users don't need to know the proper ISO key.
Comment 2 John Thomas CLA 2007-10-16 16:45:08 EDT
(In reply to comment #1)
> Step 14  >STEM>Geography>Political>Country>JPN(2)  should use "JPN(0,1,2) Full
> infrastructure" instead of "JPN(2)".  The later only has the Nodes and so is
> missing the connections between the Nodes through which the disease can travel.
> 

That did not seem to help.  I redid the steps and selected "JPN(0,1,2) Full" but it did not make any diference

> I did notice that the Infector Wizard wasn't working correctly.  I opened bug
> https://bugs.eclipse.org/bugs/show_bug.cgi?id=206459 for that.  When it works
> correctly, the names of the different regions of a country are displayed so
> users don't need to know the proper ISO key.
> 

I got around this by using the property editor on the infector.

Comment 3 John Thomas CLA 2007-10-18 16:40:00 EDT
Created attachment 80701 [details]
New Project tutorial

This adds the html help text for a tutorial to build a new project
Comment 4 John Thomas CLA 2007-10-18 16:49:16 EDT
I am now able to build a project with a scenario that will run.  
I needed the fix for bug 206459 and I needed to use the "Spanish Flu" disease from the Diseases tap  Stem->Built-in->Spanish Flu 

A working set of instructions have been added to the tutorial help files 

This bug can be closed 
Comment 5 Daniel Ford CLA 2007-10-19 12:30:21 EDT
committed the tutorial patch.
Comment 6 Daniel Ford CLA 2009-10-29 11:11:08 EDT
Comment on attachment 80701 [details]
New Project tutorial

flagged for iplog