
GRA004.TXT



gINT Rules Code Add-In menus Samples - 004



Requires gINT version 7.1.028 or later.



NOTE:  Code samples are provided free of charge and as-is.  gINT Software makes no claim or warranty as to the accuracy of the samples.  It is the responsibility of the user to ensure that the code performs as it should.  Comments, suggestions, and error reports are appreciated.



Acknowledgements

================

We wish to thank Tony Daly of Mouchel Parkman for suggesting this gINT Rule.



Description

===========

You are working on a road project and have a road centerline. At various locations along the centerline boreholes are drilled offset left and right of the centerline. You wish to draw fence diagrams for each group of these boreholes. To do so you need to draw a baseline perpendicular to the centerline at each of these groups. This Add-In facilitates the process of drawing this baseline.



This Add-In inserts the "GRA004" submenu under the "Add-Ins" menu in Input with the command "Generates Baselines" under this submenu.  "Generates Baselines" does the following:

1. Asks for the centerline file. This must be a CSV (comma separated values) file of the following structure:

East1,North1

East2,North2

...



For example:

1036.52,2000.08

1135.16,2000.08

1154.16,1999.19



If you have your project site map in the Input:Site Map application and the centerline is drawn in the site map, you can easily generate this file as follows:

  A. Bring up the properties of the centerline polyline.

  B. Click the launch button [...] right of the Coordinates property.

  C. At the bottom of the dialog, click on the [Export] button and save to any location with any name and a CSV extension (not required but recommended).



In the sample project provided with this download, move to the Site Map application in Input and preview. The centerline is the long dashed line. You can experiment with this line by performing the above steps.



2. After the centerline file is specified, a dialog appears with the following fields:

  Baseline File Name:  Just provide the name. A ".CSV" extension will be provided for you and the file will be saved in the same folder as the centerline file. We recommend naming the file by the distance along the centerline (see next field).

  Distance along CL:  The distance along the centerline that the perpendicular baseline is to be drawn.

  Offset Left of CL:  The distance left of the centerline the perpendicular baseline is to be started.

  Offset Right of CL:  The distance right of the centerline the perpendicular baseline is to be ended.

  View toward CL start:  By default the baseline will be constructed so that you are looking at the baseline with the start of the centerline behind you and the end of the centerline in front of you. Therefore, boreholes that are offset left will be on your left and those offset right will be on your right. By marking this field (it is a checkbox), the baseline will be reversed so that boreholes that are offset left will appear on the right of the fence.



On clicking the [Ok] button, the program generates the baseline file and brings up the dialog once more with the same values as the previous dialog. You can continue generating as many baselines as you wish. When completed, click the [Cancel] button.



To use the generated baselines, move to Output:Fences and click the launch button [...] right of the Baseline field (under the FENCE OPTIONS section of the screen). Then click on the [Import] button and select one of the generated baselines. If there are coordinates in the Baseline grid dialog, they will be cleared during the import process so that only the imported data remain.



After importing the baseline and clicking the [Ok] button, you can then see the baseline on your site map by clicking the [Site Layout] button (after the FENCE OPTIONS label).



You can use the sample project to generate the centerline file (see instructions above) and to generate four baselines. You can use the following values for the baseline generation:

  Baseline File Name:  382

  Distance along CL:  382

  Offset Left of CL:  85

  Offset Right of CL:  85



  Baseline File Name:  862

  Distance along CL:  862

  Offset Left of CL:  75

  Offset Right of CL:  115



  Baseline File Name:  1290

  Distance along CL:  1290

  Offset Left of CL:  40

  Offset Right of CL:  85



  Baseline File Name:  1776

  Distance along CL:  1776

  Offset Left of CL:  90

  Offset Right of CL:  90



At output use the GRA004 fence form and import the first baseline. Set the "Maximum Baseline Offset" (right of the Baseline field) to 30. This will limit the output to just those boreholes within 30 feet of the baseline. Preview or output the fence. Continue the process for the other three baselines. The maximum baseline offset of 30 works for all four baselines. It will be different for your projects.



Revision History

================

11 Sep 2005:

Initial public upload

*************************************************



INCLUDED FILES:

GRA004.GLB:

  Add-Ins:   GRA004-FenceBaseline



  gINT Rules code modules:

    GRA004:  Main

             BaselineDataInvalidFnB

             BaselineGenerate

             BaselinesPerpToCL



  Fences:    GRA004



GRA004.GPJ:

  Sample project that makes use of the code.

*************************************************



INSTALLATION PROCEDURE:

Copy the files wherever you prefer.  To see the gINT Rules Add-In and code module you must either merge the GLB into your library (Utilities:Lib Merge/Copy) or change to the included library (File:Change Library).

*************************************************



SPECIAL NOTES:

See the DESCRIPTION section above for detailed usage instructions.

*************************************************