shp_read/3
Reads a part of a standard G.I.S. 'shape-file', asserting all G.I.S. data as [Prolog clauses
shp_read(SHAPEFILEname,StartRecord,EndRecord) -(i,i,i)
Compatibility: Exclusively G.I.S. Prolog.
Remarks:
1) This predicate reads a part of a standard G.I.S. "shape-file" (*.SHP), converting all G.I.S. information to Prolog terms, asserted in a Global Database of Prolog Clauses (which can reside in RAM memory or in a disk-file, depending on the clause storage option "use external database"; See the sub-menu "G.I.S. Prolog Options", to learn how to change this setting).
2) The "part" of the ShapeFile is defined by arguments 2 and 3: Argument 2 is the "Start-Record" and argument 3 is the "End-Record" of the G.I.S. Data-objects residing in the ShapeFile. All other G.I.S. records are ignored.
3) The Prolog terms generated from the shape-file data have a proprietory predicate format, which is left undocumented (in G.I.S. Prolog version 1.01); this predicate format may be changed in future versions, without warning.
BETA-testing historical notes:
This predicate was ommitted, in the very first version of G.I.S. Prolog (version 1.00.00), pre-released on the 21st of February 2005 (to a restricted Internet public of beta-testers). As of now (version 1.01), it is included in G.I.S. Prolog, but beta-testing continues: There is either a bug in the predicate or else a bug in certain files used, since there are occasional errors in reading shape-file terms (typically 1 in a thousand; At the moment, error-ridden shapefile records are ignored during the processing phase).
See also: