Search Icon

    Introduction to the PPL_WoodPoleMaker Package

    PPL_Min API

    Introduction

    The PPL_WoodPoleMaker package is a utility (helper) component designed to simplify the creation of wood pole models within systems that use the PPL_Min API. It enables developers to generate fully populated wood‑pole objects by supplying only a concise, human‑readable descriptor containing the pole’s length, class, species, and standard. The package automatically interprets the input string—regardless of delimiter—and returns structured attribute data ready to apply to a PPLWoodPole instance. This greatly reduces manual data entry, enforces consistency, and streamlines workflows for applications needing accurate wood‑pole metadata.

    The PPL_WoodPoleMaker helper class is associated with the PPL_Min library, which is published on NuGet (https://www.nuget.org ). To locate the package search on PPL_WoodPoleMaker.

    Here is a C# snippet of the use of the PPL_WoodPoleMaker:

     

     

    WoodPoleMaker Image

     

    The string specifying the pole is in the form “Length\Class\Species\Standard”. The delimiter can be any non-alphanumeric, non-blank character. Some examples are:

    • "45\4\SOUTHERN PINE\ANSI"
    • "45\4\SOUTHERN PINE\NESC Standard"
    • "45,4,SP,GO 95"
    • "45/4/SP/CSA"
    • "45-4-SP"

    The Length is the pole’s manufactured length in units of feet. The Class is the standard numeric class or the values “H1” through “H6”. The Species can be either the full name, such as “Southern Pine”, or the standard abbreviation “SP”. The list of available species with their standard abbreviations are:

    • "PONDEROSA PINE", "PP"
    • "WESTERN RED CEDAR", "WC"
    • "JACK PINE", "JP"
    • "LODGEPOLE PINE", "LP"
    • "RED PINE", "RP"
    • "REDWOOD", "RW"
    • "SITKA SPRUCE", "SS"
    • "WESTERN FIR", "WF"
    • "WHITE SPRUCE", "WS"
    • "ALASKA YELLOW CEDAR", "YC"
    • "DOUGLAS FIR", "DF"
    • "OTHER", "UNK"
    • "SOUTHERN PINE", "SP"
    • "WESTERN LARCH", "WL"
    • "YELLOW CEDAR", "YC"
    • "WESTERN HEMLOCK", "WH"
    • "SCOTS PINE", "SCP"
    • "DOUGLAS FIR", "DFC"
    • "WESTERN LARCH", "WL"
    • "EASTERN WHITE CEDAR", "EWC"
    • "EASTERN WHITE PINE", "EWP"
    • "SPRUCE", "S"
    • "AMABILIS FIR", "AF"

    Finally, the supported Standards may be specified simply as “ANSI” or “CSA”. If left blank, it defaults to “ANSI”. Additional standard bodies include:

    • "NESC Standard"
    • "GO 95"
    • “CSA Standards”
    • "NESC Alternate"
    • "Other"
    • "NESC Legacy"
    • "GO 95 Legacy"