Metadata-Version: 1.0
Name: OWSLib
Version: 0.3
Summary: OGC Web Service utility library
Home-page: http://trac.gispython.org/projects/PCL/wiki/OwsLib
Author: Sean Gillies
Author-email: sgillies@frii.com
License: BSD
Description: OWSLib
        ======
        
        Package for working with OGC map, feature, and coverage services.
        
        OWSLib provides a common API for accessing service metadata and wrappers for
        GetCapabilities, GetMap, and GetFeature requests.
        
        Dependencies
        ------------
        
        OWSLib requires elementtree (standard in 2.5 as xml.etree) or lxml.
        
        Usage
        -----
        
        Find out what a WMS has to offer. Service metadata:
        
        >>> from owslib.wms import WebMapService
        >>> wms = WebMapService('http://wms.jpl.nasa.gov/wms.cgi', version='1.1.1')
        >>> wms.identification.type
        'OGC:WMS'
        >>> wms.identification.version
        '1.1.1'
        >>> wms.identification.title
        'JPL Global Imagery Service'
        >>> wms.identification.abstract
        'WMS Server maintained by JPL, worldwide satellite imagery.'
        
        Available layers:
        
        >>> list(wms.contents)
        ['us_landsat_wgs84', 'modis', 'global_mosaic_base', 'huemapped_srtm', 'srtm_mag', 'daily_terra', 'us_ned', 'us_elevation', 'global_mosaic', 'daily_terra_ndvi', 'daily_aqua_ndvi', 'daily_aqua_721', 'daily_planet', 'BMNG', 'srtmplus', 'us_colordem', None, 'daily_aqua', 'worldwind_dem', 'daily_terra_721']
        
        Details of a layer:
        
        >>> wms['global_mosaic'].title
        'WMS Global Mosaic, pan sharpened'
        >>> wms['global_mosaic'].boundingBoxWGS84
        (-180.0, -60.0, 180.0, 84.0)
        >>> wms['global_mosaic'].crsOptions
        ['EPSG:4326', 'AUTO:42003']
        >>> wms['global_mosaic'].styles
        {'pseudo_bright': {'title': 'Pseudo-color image (Uses IR and Visual bands, 542 mapping), gamma 1.5'}, 'pseudo': {'title': '(default) Pseudo-color image, pan sharpened (Uses IR and Visual bands, 542 mapping), gamma 1.5'}, 'visual': {'title': 'Real-color image, pan sharpened (Uses the visual bands, 321 mapping), gamma 1.5'}, 'pseudo_low': {'title': 'Pseudo-color image, pan sharpened (Uses IR and Visual bands, 542 mapping)'}, 'visual_low': {'title': 'Real-color image, pan sharpened (Uses the visual bands, 321 mapping)'}, 'visual_bright': {'title': 'Real-color image (Uses the visual bands, 321 mapping), gamma 1.5'}}
        
        Available methods, their URLs, and available formats:
        
        >>> [op.name for op in wms.operations]
        ['GetTileService', 'GetCapabilities', 'GetMap']
        >>> wms.capabilities.getOperationByName('GetMap').methods
        {'Get': {'url': 'http://wms.jpl.nasa.gov/wms.cgi?'}}
        >>> wms.capabilities.getOperationByName('GetMap').formatOptions
        ['image/jpeg', 'image/png', 'image/geotiff', 'image/tiff']
        
        That's everything needed to make a request for imagery:
        
        >>> img = wms.getmap(   layers=['global_mosaic'],
        ...                     styles=['visual_bright'],
        ...                     srs='EPSG:4326',
        ...                     bbox=(-112, 36, -106, 41),
        ...                     size=(300, 250),
        ...                     format='image/jpeg',
        ...                     transparent=True
        ...                     )
        >>> out = open('jpl_mosaic_visb.jpg', 'wb')
        >>> out.write(img.read())
        >>> out.close()
        
        A very similar API exists for WebFeatureService. See
        tests/MapServerWFSCapabilities.txt for details.
        
        Known Issues
        ------------
        
        OWSLib works with WMS version 1.1.1 and WFS 1.0.0 Other versions are not
        supported at this time.
        
        Support
        -------
        
        OWSLib shares a wiki and email list with the Python Cartographic Library:
        
        http://lists.gispython.org/mailman/listinfo/community
        
        http://trac.gispython.org/projects/PCL/wiki
        
        Updated project information can be found at
        
        http://trac.gispython.org/projects/PCL/wiki/OwsLib
        
Keywords: gis ogc ows wfs wms capabilities metadata
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Scientific/Engineering :: GIS
