Home    Reference Manuals    Return   

Create a Sine Wave in program TSIM

This tutorial consists of the following steps:

• Start program GENSYS
  
• Copy the example to your working directory
  
• Examine the directory "intro_tutor_sine"
  
• Run the example runf/sine.tsimf
  
• Examination of the results in MP2ASCII
  
• Examine the results in postprocessor MPLOT
  
• Running MPLOT without an initial file
  
• Running in batch
  
• Using Octave
  

Start program GENSYS

If the installation has been made for KDE or GNOME just click on -icon on the desktop.

On other systems open a terminal and write the command: gensys

If the gensys-window has been started via the -icon, the gensys filemanager will start in directory $HOME/gensys_analyse. In the title of the gensys-window you can see where you are located. The gensys-window is described in more detail in the genfile users manual.

Copy the Sine Wave example to your working directory

• Create a new and empty directory by writing
  mkdir tutor_sine 
  in the "Command input area" of the gensys window.

• Go to the new directory by writing
  cd tutor_sine 

• Copy example files to the newly created directory. Please choose one of the following methods:
  • Pressing Help -> Examples Html in the gensys-window
  • Pressing Help -> Examples Filemanager in the gensys-window
  • Download the example via a tar-file from Internet

  ---

  
  

  Examine the directory "intro_tutor_sine"

  Input data for the time simulation program is located in the subdirectory runf.
  
  List the contents in subdirectory runf by, double-clicking on directory runf/ in the subdirectory-field to the left
  
  Open the file runf/sine.tsimf by double-clicking on the file runf/sine.tsimf in the file-field to the right.
  Select open->op with the right mouse button

  

  ---

  
  

  Examine file runf/sine.tsimf

  The file runf/sine.tsimf will now be opened in the gensys standard editor NEDIT. In the NEDIT-editor a language mode "GENSYS" has been defined. The editor will therefore highlight valid gensys-commands. You can change the default editor by defining the environment variable: $genedit.

  
  

  ---

  
  

  Run the example runf/sine.tsimf

  Double-click file runf/sine.tsimf and select open->run with the right mouse button. The execution of program TSIM will now start, using file runf/sine.tsimf as input.

  
  

  ---

  
  

  Examination of the results in MP2ASCII

  As the screen-shoot above shows, a new file sine.id in directory id has been created. The file id/sine.id is a binary file written in a format named MPdat and cannot directly be viewed in a text-editor. However the id/sine.id-file is associated with the mp2ascii-scripts which translates the results into a readable ASCII-file.
  Double-click the name of the file id/sine.id and select open->genrun with the right mouse button.
  
  
  The checkboxes are:
  

  Full dump of MPdat-file	=>	Writes all results vectors all time steps
  Store output in file	=>	Writes the result to file list/sine.list
  Write output in matlab-format	=>	Write the output in matlab m-format

  
  If no checkboxes are checked, only a short dump to a temporary file will be written.

  A screen shoot of the output from program MP2ASCII:
  

  ---

  
  

  Examine the results in postprocessor MPLOT

  • Double-click directory mplotf/ in the subdirectory text area.
  • Double-click file mplotf/sine.mplotf in the file text area.
  • Select open->run with the right mouse button.
  • When the scripts starts and asks for an ident, press the browse-button and double-click on the sine.id-file:
    

  • Press the  OK -pushbutton.

  • Program MPLOT now starts using the file mplotf/sine.mplotf as the input data file and sine as ident.

  • In file mplotf/sine.mplotf there are three pages defined. Program MPLOT starts showing page #1, which consists of the sine-wave v.s. time.

  • Select page with the radio-buttons up in the pulldown menu bar, or press the PageUp- and PageDown-keys.

  • The second page shows time v.s. time.

  • The third page shows time v.s. the sine-wave.

  The first plot generated by program MPLOT will look as:

  
  
  
  

  Close the MPLOT-window before continuing.
  Close also the MPLOT terminal window which is running in the background.

  
  

  ---

  
  

  Running MPLOT without an initial file

  • First make sure that your mouse not is holding a primary selection.
    In order to do so, click the  cmd –pushbutton with your right mouse button and select "Clear Primary Selection".
  • Press the  Mplot –pushbutton up in the pulldown menu bar.
  • Open an ident by pressing File->open mpdat-file in the MPLOT pulldown menu.
  • Select ident sine in the selection_popup menu.
  • The other ident mplot_id is the default empty ident to be used when no ident has been defined.
  • Draw a curve by pressing Draw->curve_from_current_ident in the Pulldown Menu.
  • A selection_popup menu will now appear, double-click on the curve you like to plot.

  Close the MPLOT-window before continuing.

  
  

  ---

  
  

  Running in batch

  The programs in GENSYS can also be executed in batch. Is useful when performing parametric studies:

  • Close all windows except the Genfile-window
  • Double-click directory ./ in the Subdirectory area
  • Double-click the executable file sine.bat in the File area, select open->run with mouse button #3
  
  

  ---

  
  

  Using Octave

  The sin2-variable can also be created in octave, see input data file runf/sine_octave.tsimf. Go to Run the example and do the same exercise again but with file runf/sine_octave.tsimf.