Converts a file of Public Land Survey (PLS) descriptions into a shapefile or geodatabase feature class, as points or polygons.
FEATURE LOCATION - One {POINT | POLYGON} is generated from the PLS location described in each record in <in_file>. This is done by:
SELECT POLYGON - Selecting the first polygon encountered in <pls_fc> whose <pls_field> value is the same as the township/range/section ID in <in_file>.
CALCULATE SUBDIVISION POLYGON - (for POLYGON option) Calculating from the selected polygon the subdivision identified by the subdivision ID in <in_file>. In other words, if the subdivision ID is SW, then calculating the southwest quarter of the polygon. If the subdivision ID is blank, then the whole polygon is taken. NOTE - Calculation is done by means of PROPORTIONAL SUBDIVISION, see below.
CALCULATE SUBDIVISION POINT - (for POINT) Calculating the centerpoint of the subdivision polygon. In other words, if the subdivision ID is SW, then calculating the centerpoint of southwest quarter of the selected polygon. NOTE - Calculation is done by means of PROPORTIONAL SUBDIVISION, see below.
PROPORTIONAL SUBDIVSION - The selected <pls_fc> polygons are proportional subdivided to create subdivision points and polygons. This is done by:
LOCATE POLYGON CORNER POINTS - The 4 polygon corners are defined as the vertices of the polygon which are closest to the corners of its MBR (minimum bounding rectangle.)
CALCULATE EXTERNAL SUBDIVISION CORNER POINTS - The 4 sides formed between the 4 polygon corners are proportionally subdivided along their lengths to determine the location of the external subdivision corners, those which fall along the perimeter of the polygon. For example, if the subdivision ID in the <in_file> is SW, then the midpoint of the 4 sides is calculated to determine the location of the external quarter-section corners.
CALCULATE INTERNAL SUBDIVISION CORNER POINTS - Lines are formed between the external subdivision corners on opposite sides of the polygon, and these lines are intersected to determine the location of the internal subdivision corners. For example, if the subdivision ID is SW, then 2 lines are formed, one between the quarter-section corners on the north and south sides of the polygon, and the other between the quarter-section corners on the east and west sides. Then these lines are intersected to locate the internal quarter-section corner. Likewise, the intersection of the lines formed between external quarter-quarter-section corners are used as the internal quarter-quarter-section corners, and so on.
USE INTERNAL CORNERS AS SUBDIVISION POINTS (for POINT, and POLY label points) - The internal subdivision corners are used as the subdivision points. For example, if no subdivision ID is given (thus defaulting to the whole selected polygon), then the internal quarter-section corner is used as the centerpoint of the polygon. Likewise, if the subdivision ID is SW, then the quarter-quarter-section corner in the southwest quarter-section of the polygon is used as its centerpoint.
CONNECT CORNERS TO FORM SUBDIVISION POLYGONS (for POLYGON option) - The subdivision corners are connected to form the subdivision polygons. For example, if the subdivision ID is SW, then the SW polygon corner, the west quarter corner, the center quarter corner, and the south quarter corner are connected to form a polygon around the southwest quarter of the section. NOTE - subdivision polygons on the edge of the polygon incorporate the boundary of the polygon into their boundaries. For example, if there are intermediate vertices between the SW polygon corner and the west quarter corner, then these vertices are included in the southwest quarter-section polygon when it is constructed.
NOT ALWAYS LEGALLY CORRECT - Proportional subdivision is not always the 'legally' correct way of subdividing sections. For instance, sections along the north and west sides of townships are usually not exactly 640 acres in size and 'legally' should not be proportionally subdivided. The quarter-quarter sections along the north and west sides of the township are usually 'lots' and are usually not the same size as the other quarter-quarter sections, otherwise known as aliquot parts.
However, PLSARC is designed not to follow 'legal' rules, but instead to mimic how most people have used the PLS system as a general locational tool, as apposed to a legal tool.
plsarc <in_file> <out_path> <out_fc> <point | polygon> <pls_fc> <pls_field> {reject_file1} {reject_file2}
Parameters
| Expression | Explanation |
|---|---|
| <in_file> | The input text file that contains PLS descriptions.
|
| <out_path> | The path of the folder or geodatabase in which the <out_fc> is to be created.
|
| <out_fc> | The name for the output shape file or geodatabase feature class.
|
| <point | polygon> | The shape type for the <out_fc>.
|
| <pls_fc> | The shape file or geodatabase feature class that contains the section polygons.
|
| <pls_field> | The field of the <pls_fc> table that identifies the township, range, and section number of each polygon.
|
| {reject_file1} | The name of the text file which will contain any records from the <in_file> whose township/range/section ID did not find a match in the <pls_field>, i.e. are outside of the <pls_fc>.
|
| {reject_file2} | The name of the text file which will contain any records from the <in_file> with invalid subdivision ID's, eg. SWSS.
|
Command Line Example
plsarc "C:\Documents and Settings\dchatfie\My Documents\plsarc\in_file" "C:\Documents and Settings\dchatfie\My Documents\plsarc" junk40.shp polygon "C:\Documents and Settings\dchatfie\My Documents\plsarc\testdb.mdb\plss3_polygon" trs Executing (plsarc_3): plsarc "C:\Documents and Settings\dchatfie\My Documents\plsarc\in_file" "C:\Documents and Settings\dchatfie\My Documents\plsarc" junk40.shp polygon "C:\Documents and Settings\dchatfie\My Documents\plsarc\testdb.mdb\plss3_polygon" trs # # Start Time: Thu Feb 02 18:24:36 2006 Running script plsarc... Creating keyfile from input file... Reselecting PLS with keyfile... Converting legal descriptions to coordinates... Finding polygon with same subject... Checking aliquot part and determine position... Subdividing polygon... Outputing feature... Done running plsarc Completed script plsarc... Executed (plsarc_3) successfully. End Time: Thu Feb 02 18:25:01 2006 (Elapsed Time: 25.00 secs)
plsarc (in_file, out_path, out_fc, shape_type, pls_fc, pls_field, reject_file1, reject_file2)
Parameters
| Expression | Explanation |
|---|---|
| in_file (Required) | The input text file that contains PLS descriptions.
|
| out_path (Required) | The path of the folder or geodatabase in which the <out_fc> is to be created.
|
| out_fc (Required) | The name for the output shape file or geodatabase feature class.
|
| shape_type (Required) | The shape type for the <out_fc>.
|
| pls_fc (Required) | The shape file or geodatabase feature class that contains the section polygons.
|
| pls_field (Required) | The field of the <pls_fc> table that identifies the township, range, and section number of each polygon.
|
| reject_file1 (Optional) | The name of the text file which will contain any records from the <in_file> whose township/range/section ID did not find a match in the <pls_field>, i.e. are outside of the <pls_fc>.
|
| reject_file2 (Optional) | The name of the text file which will contain any records from the <in_file> with invalid subdivision ID's, eg. SWSS.
|
Script Example
import plsarc
plsarc.main("C:\Documents and Settings\dchatfie\My Documents\plsarc\in_file", \
"C:\Documents and Settings\dchatfie\My Documents\plsarc", "junk40.shp", "polygon", \
"C:\Documents and Settings\dchatfie\My Documents\plsarc\testdb.mdb\plss3_polygon", "trs")