Computer Modelling Group Ltd.

Introduction to
Launcher

Tutorial
CMG’s Launcher Application  
 
CMG’s  Launcher  application  was  designed  to  aid  users  in  organizing  files  and  programs.  
Launcher contains numerous advantages to using Windows Explorer such as allowing the user 
to create projects to organize files, allows convenient access to help manuals and tutorials, and 
organizes all installed versions of CMG software. 
 

Launcher Sections 
1. When installed, the Launcher icon will appear on the desktop.  Double‐click on the icon 
to open Launcher (if not already open).  
 
2. Once open it can be noted that Launcher is divided into 4 main sections: 
 
 
 
 
 
 
 
 
 
 
 
 
2
1  
 
 
 
 
 
 
 
3
 
 
 
 
 
 
 
 
4
 
 

1|Page
Section 1: 
The purpose of Section 1 is to help in the organization of folders.  Specific folders can be 
navigated to by using the         buttons on the top menu bar.   
 
Section 2: 
After  the  appropriate  folder  has  been  navigated  to  in  Section  1  the  contents  of  the 
folder will appear in Section 2. 
 
The files being shown in this window can be filtered based on their associated use (e.g. 
Simulator  files,  Results  files,  etc.)  by  using  the  filter  option  on  the  top  toolbar 
(highlighted below).   
 
 
  
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
Files  in  this  section  can  be  copy/pasted  by  right  clicking  on  them  and  selecting 
copy/paste  (please  note  that  the  CTRL+C  and  CTRL+V  shortcuts  are  not  currently 
supported in Launcher but may be in a future version). 
 
Files in this section can be opened in a CMG product or run in a simulator by ‘dragging 
and dropping’ it onto the associated executable’s icon in Section 3. 
 
Section 3: 
This section contains CMG products organized by version in a tabular fashion.  Certain 
products may be opened in their associated Guided User Interfaces’ (GUI’s) by double 
clicking  on  them.    These  include  Builder,  Results  3D,  Results  Graph,  WinProp,  and 
CMOST.  The simulators (IMEX, STARS, and GEM) do not have associated GUIs and are 
instead just executables. 
 

2|Page
 Non‐CMG executables may be added to this window as shortcuts.  Common programs 
may  include  Microsoft  Office  products  (Excel,  PowerPoint,  etc.)  text  editing  software 
(Textpad, Notepad, etc.) or other programs. 
 
Section 4: 
  This section displays information on queued, completed, or running datasets.   
 
To  launch  a  dataset  the  user  drags  and  drops  the  .dat  file  (main  dataset)  onto  the 
associated  simulator.    After  selecting  the  appropriate  run  options  from  the  window 
which  appears  (covered  in  Exercise  1)  the  run  will  be  launched  and  appear  in  this 
section. 
 
 
 
 
 
Information displayed relating to the runs that will be of most interest include the Name 
of the file, the Status, Scheduler, Submitted, Started, and Finished times.   
 
Shown  in  the  above  image  is  what  a  user  may  expect  to  see  when  a  simulation  in 
Completed, Running, and still waiting to start.   
 
If  a  run  has  failed  to  launch  to  then  it  will  turn  Red  (as  opposed  to  the  Green  shown 
above) indicating that it has encountered an issue.  It should be noted, though, that this 
may not be related to the run terminating abnormally or due to an error while running 
(as often these runs will display Complete and the user will need to look at the .Log file 
to determine if the run was successful).   
 
Scheduler refers to the computer or resource that the simulation was ran on.  If Local is 
listed then the run was done on the current machine.  Launcher allows users to send a 
simulation  to  a  separate  computer  or  cluster  through  different  schedulers  (common 
ones include Microsoft Compute Cluster Server, LSF, and SunGrid Engine). 
 
‘Submitted  At’  indicates  when  the  simulation  was  launched.    This  may  not  necessarily 
coincide  with  the  ‘Started  At’  time  as  when  a  simulation  starts  will  be  based  on 
availability of both computer and license resources.  Simulations may also be queued by 
the  user  to  start  running  based  on  numerous  controls  (a  specific  time,  after  another 
specified simulation in complete, etc.). 
 
‘Finished  At’  indicates  the  date  and  time  that  the  simulation  was  completed.    The 
difference  between  the ‘Started At’ and  ‘Finished  At’  times give  the  elapsed  run‐time.  
This can also be found at the bottom of the .Log file.      
 
 

3|Page
Other Launcher Options 
Launcher contains other features to aid the user in use of CMG products. 
 
Projects: 
Users can create Projects to associate their files with.  Projects can act as a bookmark 
for  runs  associated  with  each  other.    To  add,  modify,  or  delete  a  project  use  the 
shortcuts on the menu bar:     
 
 
 
 
 
 
 
 
 
 
 
 
 
Projects can be quickly switched by using the top toolbar’s Project dropdown. 
 
 
 
 
 
 
 
 
 
 
 
 
Please note that if a project is deleted the files associated with it are not deleted.   
 
 
 
 
 
 
 
 
 

4|Page
Documentation Browser: 
The Documentation Browser (opened with the toolbar shortcut         or the Help Menu) 
sorts the available manuals and help materials by version for the easy viewing.   
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
Materials displayed will, by default, include the Manuals in PDF and .CHM (help format) 
in both English and Spanish versions.  By checking the box to Show All Files the user is 
able to view other materials and Readme files contained in the documentation. 
 

Help Materials 
To  assist  users  in  the  application  of  CMG  software  manuals  and  template  files  have  been 
included with each installation. 
 
Manuals: 
Please refer to the Other Launcher Options section for location of CMG’s Manuals.  The 
manuals come in both English and Spanish.   
 
PDF  versions  of  the  manuals  are  available  but  it  is  the  .chm  (Help  Format)  which  is 
recommend by CMG.  The .chm file for the simulators contains 3 tabs: 

5|Page
 a. Contents‐  An  interactive  table  of  contents  which  is  organized  based  on  the 
different sections of a dataset.   
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
b. Index‐ An index of all keywords available in the associated simulator.  This list 
is helpful for users who are working in a text editor in the dataset and wish to 
gain  a  better  understanding  of  a  particular  keyword  or  who  wish  to 
implement a keyword directly into the dataset.   
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

6|Page
 c. Search‐ Will search the manual for the words input.  Results are sorted based 
on number of hits of the particular word on a per‐section basis. 
 
 
 
 
 
 
 
 
 
 
 
 
In  a  given  manual  section  the  user  is  able  to  gain  knowledge  on  all  aspects  of  the 
particular  feature  or  keyword.    This  includes  breakdowns  of  all  available  options  for 
Input  Values  and  their  definitions,  Keyword  Syntax,  Default  Values  (if  applicable), 
Conditions of usage, Explanation, and Literary References (if applicable).   
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

7|Page
Template Files: 
Template  files  are  automatically  installed  with  any  CMG  installation.    By  default  the 
template  files  can  be  found  in  the  CMG  directory.    The  location  of  the  CMG  directory 
may vary from one company to the next but the default location will be: 
 
C‐Drive  Program Files (x86)*  CMG  Associated Simulator (i.e. STARS, IMEX,  etc.)  
Associated Version (i.e. 2010.10, 2011.10, etc.)  TPL 
*Please note that CMG will be installed in Program Files (x86) on 64‐bit operating systems but will be in Program Files 
on 32‐bit systems. 
 
These files may also be found in the My Documents folder, subject to if the ‘Add Projects’ box 
was checked during installation. 
 
In  the  TPL  folder  there  will  be  multiple  subfolders  and  a  text  file  commonly  named 
template.txt.  This text file is a list of all associated templates.  For example, the first template 
referenced in this file for IMEX is mxdrm001.dat.  This file’s information is displayed below: 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
The  location  of  this  template  is  described  by  its  name.    The  ‘mx’  refers  to  the  simulator          
(e.g.  mx  =  IMEX,  st  =  STARS,  gm  =  GEM,  etc.).    The  next  3  letters  refers  to  the  subfolder  it  is 
located  in  (folder  drm).    The  final  3  numbers  are  which  dataset  in  the  subfolder  it  is  (in  this 
example the first file).   
 
Template files are fully built datasets which may be ran, opened in Builder, or opened in a text 
editor  for  examination.    Template  files  give  additional  understanding  for  the  setup  of  certain 
processes.  The template.txt file is a text document which means it may be searched in a text 
editor for a specific process being investigated to find template files associated with it.  There 
are template files for IMEX, STARS, GEM, CMOST, WinProp, Builder, and Results.    

8|Page