.. _readers.geowave:

readers.geowave
===============================================================================

.. index:: GeoWave

The **GeoWave reader** uses `GeoWave`_ to read from Accumulo.  GeoWave entries
are stored using `EPSG:4326 <http://epsg.io/4326/>`__.

.. plugin::

Example
-------

.. code-block:: json

  [
      {
          "type":"readers.geowave",
          "zookeeper_url":"zookeeper1:2181,zookeeper2:2181,zookeeper3:2181",
          "instance_name":"GeoWave",
          "username":"user",
          "password":"pass",
          "table_namespace":"PDAL_Table",
          "feature_type_name":"PDAL_Point",
          "data_adapter":"FeatureCollectionDataAdapter",
          "points_per_entry":"5000u",
          "bounds":"([0,1000000],[0,1000000],[0,100])",
          "filename":"./pdal/test/data/autzen/autzen.jpg"
      },
      {
          "type":"writers.text",
          "filename":"outputfile.txt"
      }
  ]


Options
-------

.. include:: reader_opts.rst

zookeeper_url
  The comma-delimited URLs for all zookeeper servers, this will be directly used to instantiate a ZookeeperInstance. [Required]

instance_name
  the zookeeper instance name, this will be directly used to instantiate a ZookeeperInstance. [Required]

username
  The username for the account to establish an Accumulo connector. [Required]

password
  The password for the account to establish an Accumulo connector. [Required]

table_namespace
  The table name to be used when interacting with GeoWave. [Required]

feature_type_name
  The feature type name to be used when ineracting GeoWave. [Default: PDAL_Point]

data_adapter
  FeatureCollectionDataAdapter stores multiple points per Accumulo entry. FeatureDataAdapter stores a single point per Accumulo entry. [Default: FeatureCollectionDataAdapter]

points_per_entry
  Sets the maximum number of points per Accumulo entry when using FeatureCollectionDataAdapter. [Default: 5000]

bounds
  The extent of the bounding rectangle to use to query points, expressed as a string, eg: “([xmin,xmax],[ymin,ymax],[zmin,zmax])”. [Default: unit cube]


.. _GeoWave: https://github.com/locationtech/geowave

