STISIM Drive (SDL) - PDE - Previously Defined Event
This event allows you to
call a previously defined event. You may create an event that will be used over
and over in the same events file or in different events files. The problem with
this approach is that you will always have to change the longitudinal distances
so that they will work in the current simulation. This option allows you to
create an event and reference the longitudinal distance to the one specified
for the PDE event. This means that all of the longitudinal distances in the
event you create are specific to the beginning of the event, not the beginning
of the simulation. The longitudinal distance that you specify for the PDE event
is specific to the beginning of the simulation. For this option, you must
specify a file name that contains the event, and any variables that you would
like passed to the PDE. The format for these files is the same as it is for a
normal events file.
EVENT PARAMETERS:
PARAMETER 1: |
The name of the file that contains the event to be run. The file name can be any file name that conforms to Windows file name criteria. To insure that the program can find the PDE file that is specified, make sure that you include the full file name including both the path and the file extension. For example C:\STISIM\Projects\Sample.pde. If the entire path is not included, STISIM Drive will use any directory that is specified for the STISIM Drive events file. If the PDE file cannot be found, then the simulation run will be terminated and you will have to fix the problem in order to run your file. |
PARAMETERS 2-9: |
These parameters allow
you to pass specific parameters to your PDE. This allows you to create
generic PDE files. For example, lets say you want to display a bunch of
different bill boards. The billboards will be the same size and color, but
you want a different message on each. You would create a billboard PDE event
and pass the text that will be displayed on it. The way this works is fairly
simple. When you specify a PDE event just include whatever parameters you
wish to pass to it. In the PDE you must include the @ symbol followed by a
number between 1 and 9 (@1 - @9). The program will replace the @ symbol with
the parameter you entered. You may also assign random
values to events contained in your PDE file. You may assign a random value by
using the following syntax notation: *[low range]~[high range]
(for example *10~20) In this case, the program will randomly choose a value between the low range number and the high range number. In the example, a number between 10 and 20 (inclusive) would be used. This option is extremely powerful because it allows you to add random values to any STISIM Drive event parameter. This is the only way that random values can be assigned to different event parameters. |
EXAMPLE:
10000,PDE,VEHAHEAD.PDE,*45,1000
The PDE event was created
so that you can take groups of events that will appear more than once in your scenario
and group them together. This is convenient because if a change needs to be
made it will only have to be made in one place. This is equivalent to using
subroutines when writing a computer program.
In the example, lets say
you want to use a PDE event that contains the A event and you want the speed
and longitudinal distance of the vehicle to be variable. The PDE line would
look something like that displayed above. After the driver has traveled 1000
feet down the road, the events contained in a file named VEHAHEAD.PDE would be
activated. Additionally, 2 parameters (random number between 0 and 45,1000)
will be passed to the PDE events.
Inside the VEHAHEAD.PDE
file you would have event(s) that used the parameters that were being passed.
Therefore you may have something like this:
500,A,@1,@2
1500,A,@1,500
2500,A,0,@2
When the program runs, the
events will be equivalent to
10500,A,[Random number
between 0 and 45],1000.
11500,A,[Random number
between 0 and 45],500.
12500,A,0,1000.