Function name:

Usage:

@CorrAccLoc

Returns the current accident's location along the current diagram corridor.   For a milepost corridor, this function returns the value stored in the mile_1 field.   For a hundred-block corridor, this function returns the value stored in the block_1 or block_2 field depending on which street matches the primary street in corridor study.

@CorrBegin

Returns the beginning of the corridor in the current study.  For example, if the current study examines milepost 4.5 to 9.3, this function will return 4.5.

@CorrEnd

Returns the end of the corridor in the current study. For example, if the current study examines milepost 4.5 to 9.3, this function will return 9.3.

@CorrLength

Returns the length of the corridor in the current study. For example, if the current study examines milepost 4.5 to 9.3, this function will return 4.8.  (9.3 - 4.5)

@DistGroup(0..20)

Returns the distance group values from the settings box.   The first distance value is @DistGroup(0), the second is @DistGroup(1) and so on. These values are often used in schematics to create different areas for accidents which occurred at varying distances from the intersection.

@NBArriving, @NBDeparting, @SBArriving, @SBDeparting, @EBArriving, @EBDeparting, @WBArriving, @WBDeparting

These functions perform some calculations to determine which side of the intersection an accident occurred on. The following steps are taken to determine this value:

Both of the vehicles' direction of travel values are examined to determine the overall direction of travel for the accident.  This will indicate which function will return true.  The following logic is used for this calculation:

a)  If both vehicles were traveling in the same direction that direction is the overall direction of travel for the accident.

b)  If only one of the directions was reported, it becomes the overall direction of travel for the accident.

c)  If neither of the above conditions is met, then none of these functions will return true.

The DrawData file is examined to see if it contains a value for the DIR FROM INT FIELD.  If such a value exists and specifies a direction from intersection for this accident, that value is used to determine whether the vehicle was "arriving" or "departing" the intersection.

For example, if the overall direction of travel for the accident is Northbound and the direction from intersection is indicated to be North, then @NBDeparting will return true.

If the DrawData file has no values for DIR FROM INT FIELD, the accident is assumed to be "arriving".

  @North, @South, @East, @West, @NoDir

These are constants representing North, South, East and West.  These constants apply to @Veh1Dir and @Veh2Dir

@Veh1Dir, @Veh2Dir

Returns the direction travel for vehicle 1 and 2 as interpreted by the DrawData file.

Old schematic functions, supported for backward compatibility only:

COR_B

No longer used. Returns the beginning of the corridor in the current study.  (first value) New expressions should use @CorrBegin instead.

COR_E

No longer used. Returns the end of the corridor in the current study.  (first value) New expressions should use @CorrEnd instead.

COR_L

No longer used. Returns the location along a corridor for the current accident.   New expressions should use @CorrAccLoc instead.

COR_W

No longer used. Returns the width of the corridor in the current study.  (last value - first value)  This function results in an error when used on a non-corridor diagram. New expressions should use @CorrLength instead.

DD_D1, DD_D2

No longer used. Returns the direction of travel for vehicle 1 and vehicle 2. New expressions should use @Veh1Dir, @Veh2Dir

DD_I

No longer used. Returns the direction from the intersection as interpreted by the DrawData file. New expressions should use @NBArriving, @NBDeparting, @SBArriving, etc.

DD_N, DD_S, DD_E, DD_W, DD_O

No longer used. Returns direction of travel and direction from intersection constants. New expressions should use @north, @south, @east, @west instead.