Skip to content

Commit a8fb79e

Browse files
author
David W. Lotts
committed
Manual chapter on various indexes. wiping my local clone for new pc.
1 parent 007bb1e commit a8fb79e

1 file changed

Lines changed: 33 additions & 17 deletions

File tree

extras/rya.manual/src/site/markdown/indexing.md

Lines changed: 33 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -485,17 +485,13 @@ The following two classes should be substituted when using a Geo indexe:
485485

486486
#### Geo Enable and Options
487487

488-
Geo indexing is enabled in the installer configuration builder by setting
489-
method `setUse TODO Index()` to true. For example:
488+
Geo indexing available in configuration builder.
490489

491-
```java
492-
AccumuloIndexingConfiguration.builder().setUse TODO Index(true);
493-
```
494-
495-
When using Rya with the shell command: install-with-parameters, or in legacy (not recommended) set the configuration key:
490+
When using Rya with the shell command: install-with-parameters, or in legacy mode, set the configuration key true:
496491

497492
```java
498493
OptionalConfigUtils.USE_GEO = "sc.use_geo"
494+
conf.setBoolean(OptionalConfigUtils.USE_GEO, true);
499495
```
500496
For Mongo backed Rya, the above ```USE_GEO``` is enough. If you intend to use the Accumulo backed Rya there are two geo implementations: GeoMesa and GeoWave. GeoMesa is the default, so no further configuraton is needed. If you intend to use Accumulo with GeoWave, or you have a custom Geo implementation, set the `geo_indexer_type`:
501497

@@ -511,17 +507,15 @@ GEO_MESA("org.apache.rya.indexing.accumulo.geo.GeoMesaGeoIndexer"),
511507
GEO_WAVE("org.apache.rya.indexing.accumulo.geo.GeoWaveGeoIndexer"),
512508
MONGO_DB("org.apache.rya.indexing.mongodb.geo.MongoGeoIndexer"),
513509
```
510+
##### Geo Option: GEO_PREDICATES_LIST
514511

515512
To Limit the indexing of inserted statements with particular predicates, set the following configuration key to a list of predicate URI's.
516513

517514
```java
518515
OptionalConfigUtils.GEO_PREDICATES_LIST = "sc.geo.predicates"
519516
```
520517

521-
522-
##### Geo Option: ???
523-
524-
#### Geo Usage
518+
#### Geo indexing Usage
525519
##### Query Language Accumulo GeoMesa
526520
GeoMesa is an Open Source Spatio-Temporal Indexing layer by CCRI.
527521
It uses the GeoTools API, and an Accumulo storage Model. the model stores RDF “Feature Type” with Subject, Predicate, Object, Context as “Attributes”
@@ -535,11 +529,17 @@ Point, Linestring, Polygon 
535529
The SPARQL Integration uses GeoSPARQL for storage and query.
536530

537531
##### GeoMesa Data Model
538-
OpenGIS spatial features model
539-
Features: points, lines, polygons
532+
GeoMesa use the OpenGIS spatial features model.
533+
Geo Features:
534+
- points
535+
- lines
536+
- polygons
537+
540538
For example: Fire hydrant, river, political boundaries.
541539

542-
Features may have Attributes: Strings, numbers, and others. For example: color, river flow rate, political state name. GeoTools provides the DataStore interfaces and tools.
540+
Features may have Attributes: Strings, numbers, and others. For example: color, river flow rate, political state name.
541+
542+
GeoTools provides the DataStore interfaces and tools.
543543

544544
Submit Queries using GeoTools Filters (API: Filter Factory) translated from SPARQL filters. This is expressed using *Extended Common Query Language (ECQL)*
545545

@@ -549,10 +549,20 @@ Server side iterators
549549
Space Filling curve index
550550
Geohashed spatial components
551551

552-
#### Geo Architecture
553-
Space Filling Curve and GeoHashing
552+
##### Query Language Accumulo GeoWave
553+
TODO
554554

555-
Interleave bits from Latitude and Longitude into Geohash string.
555+
##### Query Language Mongo Geo
556+
557+
TODO
558+
559+
### Geo index Architecture
560+
561+
#### GeoMesa Architecture
562+
563+
Internally, the geo index uses a #Space Filling Curve# and #GeoHashing#.
564+
565+
Interleave bits from Latitude and Longitude into a Geohash string.
556566

557567
![hash the lat long](../images/GeoHash1.png "From Lat,Long to geohash string")
558568
![hash the lat long](../images/GeoHash2.png "Lat,Long to 6 bit geohash string")
@@ -569,6 +579,12 @@ Bounded areas can be decomposed into a list of geohash ranges, searched as Accum
569579

570580
![bounded areas range of geohashes](../images/GeoAreasDecomposed.png "bounded areas described by a list geohash ranges")
571581

582+
#### GeoWave Architecture
583+
TODO
584+
585+
#### GeoMongo Architecture
586+
TODO
587+
572588
=============template==============
573589
### Index: ????
574590
This index allows optimized searching ????.

0 commit comments

Comments
 (0)