
	Applies To

	Product(s):	gINT Professional, gINT Professional Plus
	Version(s):	N/A
	Environment:	N/A
	Area:	Report-Graphic Text Doc
	Subarea:
	Original Author:	Kathleen Holcomb, Bentley Technical Support Group

A variable legend entity creates a legend displaying the material, sampler, well or other symbols in use in a single log, all boreholes on a fence report, or throughout a project (displayed in a graphic text doc). This is a useful visual aid on a report. The legend is called variable because the set of symbol boxes that appears will vary from log to log or fence to fence, depending on which symbols are in use.

To show the symbols in use in a project we will create two Graphic Text Doc reports, one in landscape and one in portrait orientation. Each will include two legends, one for material and one for sampler graphics. Then we will demonstrate how to specify the order of symbols.

Note: This exercise requires the use of training.GPJ project and training.GLB library available from: download.aspx. Instructions for unzipping and setting up these files is on: using gint downloaded examples.aspx.

Variable Graphic Legend Showing All Material and Sampler Graphics Used in a Project

Go to File->Change Library. Select training.glb and click Open.
In REPORT DESIGN, select the Graphic Text Docs tab.
Click the New icon or select File->New. The ‘New...’ dialog box appears.

In the General tab, click Reset, then enter the following:

Field	Value	Comments
Name	SIMPLE LEGEND	Name that appears in the report object selector
Description	Legend of material and sampler graphics used
Left Margin	0.6
Bottom Margin	0.425
Page Size	Letter
Orientation	Portrait
Template	data entry.gdt
Key Set	Project	Specifies the level at which data is consolidated

Click OK. The empty report is created.

We will use the TITLE PORTRAIT block from the Drawing Library to create borderlines and header text. Select Blocks->Insert Block. In the BLOCK PROPERTIES dialog box, click Reset then enter the following:

Field	Value	Comments
Block Source	Dwglib!title portrait	Click the Browse icon, select a Type of ‘DWGLIB’ and a Block of ‘TITLE PORTRAIT’.
Design Mode Color	Very Light Red	Color in REPORT DESIGN for the block insert and contents.
X	-2	X coordinate of alignment point for block insert. No effect on output.
Y	8.5	See X.

Click OK.
The report needs a title. Select Draw->Text->Text or click the Text icon, click Reset, then enter the following:

Field Value Comments
Text Expression PROJECT SYMBOL LEGEND
Height 0.14
Character size of description text.

Horizontal Alignment Right
Vertical Alignment Top
X 7.5
Y 10.1
Click OK.
We need a centered title above the first legend, which is for Material graphics. Select Draw->Text->Text or click the Text icon, click Reset, then enter the following:

Field Value
Text Expression Material Graphics
Height 0.14
Horizontal Alignment Center
Vertical Alignment Top
X 3.8
Y 8.85
Click OK.

Next we create a variable legend for material graphics. Select Graphic Text->Variable Legend, click Reset, then enter the following:

Field	Value	Comments
Field with Data	<<LITHOLOGY.Graphic>>	Source field for symbols. Use the Data Tool.
Symbol Type	Material Graphics	Type of symbol to display.
Number of Rows	4	Four rows of symbols.
Row Spacing	0.6	Row height. Needs to exceed rectangle height by some small distance for spacing.
Number of Columns	6	Six columns of symbols.
Column Spacing	1.25	Width of each column.
Fill Order	By Row	Symbols populate the legend from left to right.
Rectangle Height	0.4	Symbol rectangle height.
Rectangle Width	0.4	Symbol rectangle width.
Gap Between Descriptions and Rectangles	0.04
Text Height	0.08
X	0.06
Y	8.6

Go to the Symbol Descriptions tab and specify the following:

Field	Value	Comments
Name and/or Description	Name: Description	Specifies whether the Name (symbol code), Description or both appear, and if both, in what format. We’re printing the code first, then a colon, then the description.

Click OK.
To add a centered title above the sampler graphics legend, select Draw->Text->Text or click the Text icon, click Reset, then enter the following:

Field Value
Text Expression Sampler Graphics
Height 0.14
Horizontal Alignment Center
Vertical Alignment Top
X 3.8
Y 6.0
Click OK.

To create a variable legend for sampler graphics, select Graphic Text->Variable Legend, click Reset, then enter the following in the Main tab:

Field	Value
Field with Data	<<SAMPLE.Graphic>>
Symbol Type	Sampler Graphics
Number of Rows	2
Row Spacing	0.6
Number of Columns	6
Column Spacing	1.25
Fill Order	By Row
Rectangle Height	0.4
Rectangle Width	0.4
Gap Between Descriptions and Rectangles	0.04
Text Height	0.08
X	0.06
Y	5.75

Go to the Symbol Descriptions tab and specify the following:

Field Value
Name and/or Description Name: Description
Click OK.
Go to OUTPUT->Graphic Text Docs and preview the result.
Close the preview.

Portrait Orientation

A useful variant is the vertical project symbol report. To create this, do the following:

Go to REPORT DESIGN->Graphic Text Docs.
Select File->Copy Page. Name the copy ‘SIMPLE VERTICAL LEGEND’.
Double-click the ‘Material Graphics’ text entity, change the following values, then click OK:

Field Value
Horizontal Alignment Left
X 0.06
Double-click the ‘Sampler Graphics’ text entity, change the following values, then click OK:

Field Value
Horizontal Alignment Left
X 3.8
Y 8.85
Double-click the material graphics variable legend entity, change the following values, then click OK:

Field Value
Number of Rows 14
Number of Columns 2
Column Spacing 1.5
Fill Order By Column
X 3.8
Y 8.6
Go to Output->Graphic Text Docs and preview the report.
Close the preview.

Symbol Legend Positions

The Variable Legend entity in logs, fences, and graphic text documents, by default, prints the symbols in the order that they were encountered in the output. You can override this default behavior for sampler, material, well and/or general symbols using the Symbol Legend Positions feature in SYMBOL DESIGN, which enables you to assign rankings to symbols for display in legends.

For example, you might want to order material symbols to show gravel symbols first, followed by sand, silt, clay, rock, and all others. To do this you would assign an integer to all gravels you use, a higher integer for all sands, and so on. You can skip values. It is only the relative values that are important, that is, 5 will sort before 8 and it doesn't matter that there are no 6 or 7 values. Also, you can have multiple symbols with the same legend position values, and symbols with unspecified values are placed at the end of the list.

We’ll assign the following values to material symbols used in our project:

Code	Description	Legend Position
CL	USCS Low Plasticity Clay	4
CLS	USCS Low Plasticity Sandy Clay	4
GW-GC	USCS Well-graded Gravel with Clay	1
ML	USCS Silt	3
SANDSTONE	Sandstone	5
SC	USCS Claey Sand	2
SILTSTONE	Siltstone	5
SM	USCS Silty Sand	2
SP	USCS Poorly-graded Sand	2

To demonstrate the feature, do the following:

Go to SYMBOL DESIGN and select the Material tab.
Select File->Symbol Legend Positions. The Symbol Legend Positions dialog box appears.
Enter the legend position values in the corresponding rows from the list above, then click OK.
Go to OUTPUT->Graphic Text Docs. Preview the output. The material symbols are now in gravel-sand-silt-clay-rock-other order.
Close the preview.

Field	Value
Text Expression	Material Graphics
Height	0.14
Horizontal Alignment	Center
Vertical Alignment	Top
X	3.8
Y	8.85