GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  GEO::SURFACE (3)

.ds Aq ’

NAME

Geo::Surface - A surface description.

CONTENTS

INHERITANCE



 Geo::Surface
   is a Geo::Shape



SYNOPSIS



 my $island = Geo::Surface->new($outer, $lake1, $lake2);



DESCRIPTION

In this context, a surface is defined as one filled area with possible enclosures in one projection system.

Extends DESCRIPTION in Geo::Shape.

METHODS

Extends METHODS in Geo::Shape.

    Constructors

Extends Constructors in Geo::Shape.
Geo::Surface-><B>newB>(<$surface | <$outer,$inner,...> >, %options) When called as instance method, some defaults are copied from the object where the call is made upon.

You may either provide a Math::Polygon::Surface $surface, or a LIST of lines. In the latter case, the first line is the $outer polygon of the surface, and the other are all $inner enclosures: lakes. Lines are and Geo::Line, Math::Polygon objects, or ARRAY of points.

If no projection is specified, then the projection of the first Geo-encoded line will be used.



 -Option--Defined in--Default
  proj    Geo::Shape  see Geo::Proj::defaultProjection()



proj => LABEL

    Attributes

Extends Attributes in Geo::Shape.
$obj-><B>geoInnerB>() Returns a LIST of enclosed polygons, converted to Geo::Line objects.
$obj-><B>geoOuterB>() Returns the outer polygon as Geo::Line object.
$obj-><B>innerB>() Returns a LIST of enclosed Math::Polygon objects.
$obj-><B>outerB>() Returns the outer Math::Polygon.
$obj-><B>projB>() Inherited, see Attributes in Geo::Shape
$obj-><B>proj4B>() Inherited, see Attributes in Geo::Shape

    Projections

Extends Projections in Geo::Shape.
$obj-><B>inB>(<$label|’utm’>) Inherited, see Projections in Geo::Shape
$obj-><B>projectOnB>($nick, @points) Inherited, see Projections in Geo::Shape

    Geometry

Extends Geometry in Geo::Shape.
$obj-><B>areaB>() Returns the area enclosed by the outer polygon, minus the erea of the enclosures. Only useful when the points are in some orthogonal projection.
$obj-><B>bboxB>() The bounding box of outer surface polygon.
$obj-><B>bboxCenterB>() Inherited, see Geometry in Geo::Shape
$obj-><B>bboxRingB>([$xmin, $ymin, $xmax, $ymax, [$proj]])
Geo::Surface-><B>bboxRingB>([$xmin, $ymin, $xmax, $ymax, [$proj]]) Inherited, see Geometry in Geo::Shape
$obj-><B>distanceB>($object, [$unit]) Inherited, see Geometry in Geo::Shape
$obj-><B>perimeterB>() The length of the outer polygon. Only useful in a orthogonal coordinate systems.

    Display

Extends Display in Geo::Shape.
$obj-><B>deg2dmB>($degrees, $pos, $neg)
Geo::Surface-><B>deg2dmB>($degrees, $pos, $neg) Inherited, see Display in Geo::Shape
$obj-><B>deg2dmsB>($degrees, $pos, $neg)
Geo::Surface-><B>deg2dmsB>($degrees, $pos, $neg) Inherited, see Display in Geo::Shape
$obj-><B>dms2degB>($dms)
Geo::Surface-><B>dms2degB>($dms) Inherited, see Display in Geo::Shape
$obj-><B>toStringB>([$projection]) Returns a string representation of the line, which is also used for stringification.

OVERLOAD

Extends OVERLOAD in Geo::Shape.
overload: <B>’‘‘’’’ (stringification)B> Inherited, see OVERLOAD in Geo::Shape
overload: <B>’bool’ (truth value)B> Inherited, see OVERLOAD in Geo::Shape

DIAGNOSTICS

Warning: Geo::Line is should be filled When Geo::Line objects are used to compose a surface, each of them must be filled. Representation of rivers and such do not belong in a surface description.
Error: distance calculation not implemented between a $kind and a $kind Only a subset of all objects can be used in the distance calculation. The limitation is purely caused by lack of time to implement this.
Error: in() not implemented for a $class
Error: not known what to do with $component

SEE ALSO

This module is part of Geo-Point distribution version 0.96, built on January 21, 2014. Website: http://perl.overmeer.net/geo/ All modules in this suite: Geo::Point, Geo::Proj4, Geo::WKT, Math::Polygon, Geo::GML, Geo::ISO19139, Geo::EOP, Geo::Format::Envisat, and Geo::Format::Landsat.

Please post questions or ideas to the mailinglist at geo-perl@list.hut.fi">http://geo-perl@list.hut.fi

LICENSE

Copyrights 2005-2014 by [Mark Overmeer]. For other contributors see ChangeLog.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See http://www.perl.com/perl/misc/Artistic.html

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 GEO::SURFACE (3) 2014-01-21

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.