Template Sheet

Templates are named formats for displaying various data in the log plot. For instance, a "standard" horizontal grid might be defined as having solid black lines every 500ft with dotted grey lines every 100ft. A regular "GR" curve display may specify a solid, black line, varying between zero on the left and 100 on the right, with wrap-around. A "cutoff" colour fill scheme may specify that when the log curve is less than a defined cut-off value then there should be a yellow fill between them.
The Template sheet has twelve sections. These must appear in the order given below without any blank rows between them. Borders on cells are optional but help readability. There must be a blank column to the right of each set of template parameters. After that, columns may contain notes to explain the parameter meanings and options.
The Template page must begin with the two lines:
template start
where cell A1 must contain "OPENLOGPLOT" and cell A2 must contain "TEMPLATE" (case insensitive). The values in B1 and C1 are currently ignored but reserved for future use in case new formats are introduced for the Template Sheet in future releases.
Each section is introduced with a line starting "#===" like this:
template start
with the section name preceded with a "~" character. The Template sheet must end with the lines:
template start

PLOTSETUP

The PLOTSETUP section defines the page size, orientation, margins and key parameters associated with the layout of the plot page. See Plot Layout for how these parameters control the plot layout. All dimensions are in 1/100ths of a mm.
template start
The PAGE can be "PORTRAIT" or "LANDSCAPE".
The PAGESIZE can be "A4" or "LETTER".
The TMARGIN, BMARGIN, LMARGIN, RMARGIN are the top, bottom, left and right margins.
The HDRHEIGHT is the height of the header.
The LOGOFILE is the name of the logo file (jpg, gif or png) which must be in the folder "OpenLogPlot\images".
The LOGOWIDTH, LOGOHEIGHT, LOGOOFFX and LOGOOFFY are the size and position of a logo in the header.
The HDRTXT is the text string to appear in the header.
The HDRTXTOFFX and HDRTXTOFFY are for positioning the text string in the header.
The TITLETXT is the text string to appear as the title below the header. Substitutions from the Data sheet are as follows:
  • %a - Well API Code
  • %c - Company Name
  • %d - Date of Data Acquisition
  • %f - Field Name
  • %l - Well Location
  • %p - Province Name
  • %s - Scale
  • %t - Today's Date
  • %u - Well UWI Code
  • %v - Vendor/Service Company Name
  • %w - Well Name
The TITLETXTOFFX and TITLETXTOFFY are for positioning the title string.
The HDROFF defines the gap between the header and top of the track display.
The LOGSTARTDELAY and LOGENDDELAY define the gap between the start of the track display (below the track header) and the beginning of the data plot, and the end of the data plot and the bottom of the track respectively.
The TRKGAP value defines the horizontal gap between tracks.
TOP OF PAGE

CURVES

The CURVES section provides templates for a number of named curves. These curve templates will be used in the View sheet to tell OpenLogPlot how to display the log data.
template start
The NAME must be a unique curve template name.
The DNAME is the name to display for the curve on the plot. It does not have to be unique. Notice, for instance, that in the example above there are two curve templates with a DNAME of "DEPT": one with NAME "IDEPT" (for imperial units depths) and one with NAME "MDEPT" (for metric depths).
The LEFT and RIGHT give the values of the curve at the left and right edges of the track.
SCALE determines whether the curve is interpreted against a logarithmic or linear scale. Valid values are "LIN" and "LOG".
The WRAP value is either "YES" or "NO" and determines whether the curve display is wrapped around when it overflows the left or right edge of the track.
The COLOR, STYLE and THICK define the colour, style ("SOLID" or "DASH") and thickness (in 1/100ths of a mm) of the displayed curve. A value of NULL is permitted to indicate no curve is to be shown. Colours are given in #RRGGBB hexadecimal format.
For convenience, it is useful to define a curve template called "AUTO" which specifies "AUTO" for the curve display name (meaning the log data name will be used instead) and "AUTO" for LEFT and RIGHT values (meaning that the min and max values as determined from the actual data will be substituted for left and right extremes). This template can be applied to any curve to ensure that its data is visible and is often useful when first examining new data whose data range may not be immediately apparent.
TOP OF PAGE

POINTS

The POINTS section provides templates for possible ways of displaying point data in the log display.
template start
The NAME must be a unique point template name.
The DNAME is the name to display for the points on the plot. It does not have to be unique. Notice, for instance, that in the example above there are two point templates with a DNAME of "KCORE": one with NAME "KCORE1" and one with NAME "KCOR"
The LEFT and RIGHT give the values of the point value range at the left and right edges of the track.
SCALE determines whether the point values are shown against a logarithmic or linear scale. Valid values are "LIN" and "LOG".
SHAPE determines the shape of the point on the log plot. Valid values are:
  • PLUSCROSS (like "+" sign)
  • CROSS (like "X" sign)
  • TRIANGLE
  • SQUARE
  • DIAMOND
  • PENTAGON
  • HEXAGON
  • CIRCLE
SIZE is the size of a bounding box that would contain the shape, expressed in 1/100ths of a mm.
FILL1 specifies the colour to fill the shape, in #AARRGGBB hexadecimal format (AA for transparency and RR, GG and BB for red, green and blue respectively).
FILL2 specifies a second colour to fill the shape. It is not currently used and should be set to NULL.
LINE and LTHICK define the colour and thickness (in 1/100ths of a mm) of the shape outline. LINE colour is given in #RRGGBB hexadecimal format.
JOIN, JTHICK and JSTYLE define the colour, thickness (in 1/100ths of a mm) and style of a line connecting the points. JOIN may be "NULL" to indicate no connecting line, or a colour in #RRGGBB hexadecimal format. JSTYLE can be "SOLID" or "DASH".
TOP OF PAGE

PALETTES

The PALETTES section provides templates for user-specified colour palettes, or gradients. Only two colours can be specified, at the left end and right end of the palette.
template start
The NAME must be a unique palette template name.
LEFT and RIGHT define the colour, in #RRGGBB hexadecimal format at the left and right end of the palette respectively. Note that transparency cannot be used with fills using palettes (whereas solid fills can specify transparency).
TOP OF PAGE

LITHOLOGIES

The LITHOLOGIES section provides templates for user-specified lithology patterns. This capability is not yet implemented in OpenLogPlot 2013-01 but these lines must be included in your Template file.
template startTOP OF PAGE

ELEMENTS

The ELEMENTS section provides templates for graph elements - basically equivalent to categories, lithologies, facies, minerals or whatever information you wish to plot as a graph.
template start
The NAME must be a unique element template name.
The COLOR specifies how to draw this element in #AARRGGBB hexadecimal format (AA for transparency and RR, GG and BB for red, green and blue respectively). See the GRAPHS section below on how to use elements.
TOP OF PAGE

HGRIDS

The HGRIDS section defines one or more horizontal grid templates. Note that each View specifies a default horizontal grid template while each track's HGRID definition can defer to the View, assert its own, or turn off the horizontal grid. Thus a View over a long interval may effectively specify different MAJOR and MINOR intervals than a View over a short interval. There is also an option for major and minor intervals to be calculated automatically from the selected plot depth interval.
template start
The NAME and UNITS together must form a unique hgrid template name. Thus, in the example above, the reference names of the hgrid templates are "FT:STANDARD", "M:STANDARD", "FT:FINE", etc. (i.e. in the general form of "UNITS:NAME"). If the UNITS value is "AUTO" then the display units will be taken from the units of the selected View.
The MAJOR and MINOR values specify the depths of major and minor lines in the horizontal grid in the UNITS of the hgrid. If the value of MAJOR and MINOR is "AUTO" (as for the "AUTO:DEFAULT" template above) then their values are calculated from the plot display interval so as to give 'reasonable' values.
MAJORANNOT and MINORANNOT specify whether to add depth value annotations to major and minor horizontal gridlines respectively. Valid values are "YES" and "NO".
MAJORCOLOR, MAJORSTYLE and MAJORTHICK specify the colour (in #RRGGBB hexadecimal format), style ("SOLID" or "DASH") and thickness (in 1/100ths of mm) of the major horizontal gridlines.
MINORCOLOR, MINORSTYLE and MINORTHICK specify the colour (in #RRGGBB hexadecimal format), style ("SOLID" or "DASH") and thickness (in 1/100ths of mm) of the minor horizontal gridlines.
TOP OF PAGE

VGRIDS

Vertical grids are specified by one or more VGRID templates. Vertical grids are one of the parameters of Tracks.
template start
The NAME must be a unique vgrid template name.
The SCALE must be one of "LOG" or "LIN".
DECADES specifies, for LOG vertical grids, the number of decades required. For LIN vertical grids it can be NULL.
The MAJOR and MINOR values specify the position of major and minor vertical grid lines. For "LIN" scale vertical grids these are specified in percentage values, such as 50% or 25%. For "LOG" scale vertical grids, these specify the number (1-9) of the MAJOR and MINOR vertical gridlines. For MAJOR vertical gridlines, a "1" would mean plotting a MAJOR line every 0.1, 1, 10, 100, etc. For MINOR vertical gridlines, a "1" would mean that a MINOR line is drawn at 0.2, 0.3, 0.4, ... 2, 3, 4, ..., 20, 30, 40, ..., etc.
MAJORCOLOR, MAJORSTYLE and MAJORTHICK specify the colour (in #RRGGBB hexadecimal format), style ("SOLID" or "DASH") and thickness (in 1/100ths of mm) of the major vertical gridlines.
MINORCOLOR, MINORSTYLE and MINORTHICK specify the colour (in #RRGGBB hexadecimal format), style ("SOLID" or "DASH") and thickness (in 1/100ths of mm) of the minor vertical gridlines.
VSTART specifies, for "LOG" vertical grid scales, the decade on which the value on which the grid should start. So a value of "2" means "start the grid on the 0.002, 0.02, 0.2, 2, ..., etc. on the left side of the track.
TOP OF PAGE

FILLS

The FILLS section of the Template is used to predefine the curve fills that you want to use in your plot. See Fill Options for a diagram of the possible fill options.
template start
The NAME must be a unique fill template name.
The TEST must be of the form "Cm<Cn", "Cm>Cn", "Cm<CO", "Cm>CO" or "TRUE", where "Cm" and "Cn" are curve variable specifiers like "C1", "C2", etc. standing for the first, second, etc. curve listed in the track, and "CO" stands for cut-off.
TRUEAREA is the area to fill if the test is true, expressed as shown in Fill Options. The format is LEFT|Cm|CO-CO|Cn|RIGHT (for example "LEFT-C1", "C1-CO", etc.) or it may be "NULL" to mean no fill is required.
TRUECOLOR specifies how to fill the TRUEAREA and is expressed in #AARRGGBB hexadecimal format (AA for transparency and RR, GG and BB for red, green and blue respectively). Alternatively it can be NULL (when no fill is required) or in the format "PALETTE:Cm" to mean that the colour is determined by using the curve Cm to pick a value from the PALETTE as specified in the Template (see PALETTES).
FALSEAREA is the area to fill if the test is false, expressed as shown in Fill Options. The format is LEFT|Cm|CO-CO|Cn|RIGHT (for example "LEFT-C1", "C1-CO", etc.) or it may be "NULL" to mean no fill is required.
FALSECOLOR specifies how to fill the FALSEAREA and is expressed in #AARRGGBB hexadecimal format (AA for transparency and RR, GG and BB for red, green and blue respectively). Alternatively it can be NULL (when no fill is required) or in the format "PALETTE:Cm" to mean that the colour is determined by using the curve Cm to pick a value from the PALETTE as specified in the Template (see PALETTES).
In the examples above, the ALTERNATE fill compares two curves and fills between them in different colours depending on which is the greater. The CUTOFF fill checks if the first curve in the track is greater than the cut-off value and if it not it fills from the curve to the cut-off value. (This could equally have tested for C1<CO and specified the fill in the TRUEAREA and TRUECOLOR).
TOP OF PAGE

GRAPHS

The GRAPHS template allows you to specify graphs, currently limited to "PERCENTBAR" graphs, at specified depths.
template start
The NAME must be a unique Graph name.
The TYPE must currently be "PERCENTBAR". Additional graph types will be added to later releases of OpenLogPlot.
OPERATION and INTERVAL are reserved for future use.
HEIGHT gives the height of the graph in 1/100th of mm.
A number of DATA lines follow. The data values for the graph are mapped to the successive Element templates.
JOIN, JTHICK and JTYPE define the colour, thickness (in 1/100ths of a mm) and style of a line connecting the graph elements. JOIN may be "NULL" to indicate no connecting line, or a colour in #RRGGBB hexadecimal format. JTYPE can be "SOLID" or "DASH".
TOP OF PAGE

INTERVALS

The INTERVALS template allows you to specify how sets of intervals (or zones) should be displayed.
interval template
The NAME must be a unique Interval template name.
COLOR specifies how to fill the interval and is expressed in #AARRGGBB hexadecimal format (AA for transparency and RR, GG and BB for red, green and blue respectively).
ANNOTATE specifies if the interval name should be displayed. Valid values are "LEFT", "CENTER", "CENTRE" and "RIGHT" indicating that annotation should be added and left/center/right justified. A value of "NO" indicates that no annotation should be added.
TOP OF PAGE

TOPS

The TOPS template allows you to specify how sets of tops (or horizons) should be displayed.
interval template
The NAME must be a unique Interval template name.
COLOR specifies how to fill the interval and is expressed in #RRGGBB hexadecimal format (RR, GG and BB for red, green and blue respectively).
STYLE defines the line style associated with the top. It can be "SOLID" or "DASH".
THICK specifies the thickness of the top in 1/100th mm.
ANNOTATE specifies if the top name should be displayed. Valid values are "LEFT", "CENTER", "CENTRE" and "RIGHT" indicating that annotation should be added and left/center/right justified. A value of "NO" indicates that no annotation should be added.
TOP OF PAGE

OLP