Home    Reference Manuals    Return   

Create a Sine Wave in program TSIM

• Introduction
• Download the example
• Examine the directory "intro_tutor_1_sine"
• Examine file "runf/sine.tsimf"
• 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 a m-script
• Co-simulation

Introduction

In program TSIM it is not necessary to model a mechanical system. With a fixed step integrator it is possible to create curves of plain mathematical expressions too.

Download the example

• Download the tar-file intro_tutor_1_sine.tgz
• List the contents of the tar-file with "tar tvfkz intro_tutor_1_sine.tgz"
• Extract the contents of the tar-file with "tar xvfkz intro_tutor_1_sine.tgz"

Examine the directory "intro_tutor_1_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:
  
  In file names wildcards can be used. File names with wildcards in UNIX are also called "ambiguous file references". How to write file names with wildcards can be found in https://www.linfo.org/wildcard.html

• 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.sh in the File area, select open->run with mouse button #3

Using a m-script

The sin2-variable can also be created via a m-script, see input data file runf/sine_oper.tsimf. Go to Run the example and do the same exercise again but with file runf/sine_oper.tsimf instead.

Co-simulation

Run a co-simulation using Gensys as server and program octave as client

• Initiate a time-domain simulation with input data file runf/sine_cosim.tsimf
• Program tsim starts but immediately halts with the message:
  

   -- INFO  -- In store_v
               client has connected to server_udp2
  

• Go back to the genfile window and double-click directory "." and press CTRL+T to start a terminal in current directory
• In the terminal write octave to start the octave program
• In program octave run script sine_cosim, to connect to gensys and start the co-simulation
• Start program MPLOT and plot all sine waves from all three simulations: sine, sine_oper and sine_cosim