# locationtech/geomesa architecture

> Architecture diagram of the GitHub repository locationtech/geomesa, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/locationtech/geomesa
- Repository: https://github.com/locationtech/geomesa

## Overview

GeoMesa is a geospatial data platform: users ingest feature data, store it in a backend, and query it with spatial and temporal semantics for analytics or mapping clients. The tree shows multiple database and file-backed datastores, shared query/index machinery, command-line operations, and integrations for Spark, GeoServer, and streaming. Edges are limited to relationships documented in the README or visible in excerpts; the broad tree does not expose the wiring for many listed subsystems, so those connections are omitted or marked unverified.

Main entry points: [`geomesa-accumulo/geomesa-accumulo-datastore/src/main/scala/org/locationtech/geomesa/accumulo/data/AccumuloQueryPlan.scala`](https://github.com/locationtech/geomesa/blob/main/geomesa-accumulo/geomesa-accumulo-datastore/src/main/scala/org/locationtech/geomesa/accumulo/data/AccumuloQueryPlan.scala) (Query planning), [`geomesa-accumulo/geomesa-accumulo-datastore/src/main/scala/org/locationtech/geomesa/accumulo/data/AccumuloDataStore.scala`](https://github.com/locationtech/geomesa/blob/main/geomesa-accumulo/geomesa-accumulo-datastore/src/main/scala/org/locationtech/geomesa/accumulo/data/AccumuloDataStore.scala) (Accumulo datastore), [`geomesa-fs/geomesa-fs-storage/src/main/scala/org/locationtech/geomesa/fs/storage/core/FileSystemStorage.scala`](https://github.com/locationtech/geomesa/blob/main/geomesa-fs/geomesa-fs-storage/src/main/scala/org/locationtech/geomesa/fs/storage/core/FileSystemStorage.scala) (File storage), [`geomesa-tools/src/main/scala/org/locationtech/geomesa/tools/ingest/IngestCommand.scala`](https://github.com/locationtech/geomesa/blob/main/geomesa-tools/src/main/scala/org/locationtech/geomesa/tools/ingest/IngestCommand.scala) (Ingest commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User interfaces"]
  node_geoserver["GeoServer integration"]
  node_cli["Backend tools"]
end

subgraph group_query["Query and indexing"]
  node_queryplan["Query planning"]
  node_filter["Filter translation"]
  node_accindices["Accumulo indexes"]
end

subgraph group_backends["Storage backends"]
  node_accumulo["Accumulo datastore"]
  node_hbase["HBase datastore"]
  node_cassandra["Cassandra datastore"]
  node_filesystem[("File storage")]
  node_storagecatalog[("Storage catalog")]
  node_memory[("In-memory engine<br/>[GeoCQEngine.scala]")]
end

subgraph group_analytics["Analytics and formats"]
  node_kafka["Kafka streaming"]
  node_spark["Spark analytics"]
  node_arrow["Arrow format"]
end

subgraph group_operations["Data operations"]
  node_ingest["Ingest commands"]
  node_writer["Index writer"]
  node_mapreduce["MapReduce jobs"]
end

node_users(("Users"))
node_mapping(("Mapping clients"))

node_users -.->|"submit data"| node_ingest
node_ingest -.->|"writes features"| node_accumulo
node_users -.->|"request query"| node_queryplan
node_queryplan -.->|"plans scan"| node_accumulo
node_queryplan -.->|"plans scan"| node_hbase
node_queryplan -.->|"plans scan"| node_cassandra
node_queryplan -.->|"plans scan"| node_filesystem
node_filesystem -->|"uses catalog"| node_storagecatalog
node_memory -->|"translates filters"| node_filter
node_accumulo -.->|"uses indexes"| node_accindices
node_writer -.->|"writes records"| node_accumulo
node_cli -.->|"operates datastore"| node_accumulo
node_users -.->|"run analytics"| node_spark
node_users -.->|"stream features"| node_kafka
node_queryplan -.->|"export results"| node_arrow
node_queryplan -.->|"serves queries"| node_geoserver
node_geoserver -->|"serves maps"| node_mapping
node_users -.->|"run jobs"| node_mapreduce

click node_cli "https://github.com/locationtech/geomesa/blob/main/geomesa-accumulo/geomesa-accumulo-tools/src/main/scala/org/locationtech/geomesa/accumulo/tools/AccumuloRunner.scala"
click node_ingest "https://github.com/locationtech/geomesa/blob/main/geomesa-tools/src/main/scala/org/locationtech/geomesa/tools/ingest/IngestCommand.scala"
click node_queryplan "https://github.com/locationtech/geomesa/blob/main/geomesa-accumulo/geomesa-accumulo-datastore/src/main/scala/org/locationtech/geomesa/accumulo/data/AccumuloQueryPlan.scala"
click node_accumulo "https://github.com/locationtech/geomesa/blob/main/geomesa-accumulo/geomesa-accumulo-datastore/src/main/scala/org/locationtech/geomesa/accumulo/data/AccumuloDataStore.scala"
click node_hbase "https://github.com/locationtech/geomesa/blob/main/geomesa-hbase/geomesa-hbase-datastore/src/main/scala/org/locationtech/geomesa/hbase/data/HBaseQueryPlan.scala"
click node_cassandra "https://github.com/locationtech/geomesa/blob/main/geomesa-cassandra/geomesa-cassandra-datastore/src/main/scala/org/locationtech/geomesa/cassandra/data/CassandraQueryPlan.scala"
click node_filesystem "https://github.com/locationtech/geomesa/blob/main/geomesa-fs/geomesa-fs-storage/src/main/scala/org/locationtech/geomesa/fs/storage/core/FileSystemStorage.scala"
click node_storagecatalog "https://github.com/locationtech/geomesa/blob/main/geomesa-fs/geomesa-fs-storage/src/main/scala/org/locationtech/geomesa/fs/storage/core/StorageCatalog.scala"
click node_kafka "https://github.com/locationtech/geomesa/blob/main/geomesa-kafka/geomesa-kafka-datastore/src/main/scala/org/locationtech/geomesa/kafka/index/KafkaQueryRunner.scala"
click node_spark "https://github.com/locationtech/geomesa/blob/main/geomesa-accumulo/geomesa-accumulo-spark/src/main/scala/org/locationtech/geomesa/accumulo/spark/AccumuloSpatialRDDProvider.scala"
click node_arrow "https://github.com/locationtech/geomesa/blob/main/geomesa-arrow/geomesa-arrow-gt/src/main/scala/org/locationtech/geomesa/arrow/io/SimpleFeatureArrowFileWriter.scala"
click node_memory "https://github.com/locationtech/geomesa/blob/main/geomesa-memory/geomesa-cqengine/src/main/scala/org/locationtech/geomesa/memory/cqengine/GeoCQEngine.scala"
click node_filter "https://github.com/locationtech/geomesa/blob/main/geomesa-memory/geomesa-cqengine/src/main/scala/org/locationtech/geomesa/memory/cqengine/utils/CQEngineQueryVisitor.scala"
click node_accindices "https://github.com/locationtech/geomesa/blob/main/geomesa-accumulo/geomesa-accumulo-indices/src/main/scala/org/locationtech/geomesa/accumulo/index/AccumuloFeatureIndexFactory.scala"
click node_writer "https://github.com/locationtech/geomesa/blob/main/geomesa-accumulo/geomesa-accumulo-datastore/src/main/scala/org/locationtech/geomesa/accumulo/data/writer/AccumuloIndexWriter.scala"
click node_mapreduce "https://github.com/locationtech/geomesa/blob/main/geomesa-accumulo/geomesa-accumulo-jobs/src/main/scala/org/locationtech/geomesa/accumulo/jobs/index/WriteIndexJob.scala"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_geoserver,node_cli,node_users,node_mapping toneBlue
class node_queryplan,node_filter,node_accindices toneAmber
class node_accumulo,node_hbase,node_cassandra,node_filesystem,node_storagecatalog,node_memory toneMint
class node_kafka,node_spark,node_arrow toneRose
class node_ingest,node_writer,node_mapreduce toneIndigo
```

## Components

### User interfaces

- **GeoServer integration**
- [Backend tools](https://github.com/locationtech/geomesa/blob/main/geomesa-accumulo/geomesa-accumulo-tools/src/main/scala/org/locationtech/geomesa/accumulo/tools/AccumuloRunner.scala): `geomesa-accumulo/geomesa-accumulo-tools/src/main/scala/org/locationtech/geomesa/accumulo/tools/AccumuloRunner.scala`

### Query and indexing

- [Query planning](https://github.com/locationtech/geomesa/blob/main/geomesa-accumulo/geomesa-accumulo-datastore/src/main/scala/org/locationtech/geomesa/accumulo/data/AccumuloQueryPlan.scala): `geomesa-accumulo/geomesa-accumulo-datastore/src/main/scala/org/locationtech/geomesa/accumulo/data/AccumuloQueryPlan.scala`
- [Filter translation](https://github.com/locationtech/geomesa/blob/main/geomesa-memory/geomesa-cqengine/src/main/scala/org/locationtech/geomesa/memory/cqengine/utils/CQEngineQueryVisitor.scala): `geomesa-memory/geomesa-cqengine/src/main/scala/org/locationtech/geomesa/memory/cqengine/utils/CQEngineQueryVisitor.scala`
- [Accumulo indexes](https://github.com/locationtech/geomesa/blob/main/geomesa-accumulo/geomesa-accumulo-indices/src/main/scala/org/locationtech/geomesa/accumulo/index/AccumuloFeatureIndexFactory.scala): `geomesa-accumulo/geomesa-accumulo-indices/src/main/scala/org/locationtech/geomesa/accumulo/index/AccumuloFeatureIndexFactory.scala`

### Storage backends

- [Accumulo datastore](https://github.com/locationtech/geomesa/blob/main/geomesa-accumulo/geomesa-accumulo-datastore/src/main/scala/org/locationtech/geomesa/accumulo/data/AccumuloDataStore.scala): `geomesa-accumulo/geomesa-accumulo-datastore/src/main/scala/org/locationtech/geomesa/accumulo/data/AccumuloDataStore.scala`
- [HBase datastore](https://github.com/locationtech/geomesa/blob/main/geomesa-hbase/geomesa-hbase-datastore/src/main/scala/org/locationtech/geomesa/hbase/data/HBaseQueryPlan.scala): `geomesa-hbase/geomesa-hbase-datastore/src/main/scala/org/locationtech/geomesa/hbase/data/HBaseQueryPlan.scala`
- [Cassandra datastore](https://github.com/locationtech/geomesa/blob/main/geomesa-cassandra/geomesa-cassandra-datastore/src/main/scala/org/locationtech/geomesa/cassandra/data/CassandraQueryPlan.scala): `geomesa-cassandra/geomesa-cassandra-datastore/src/main/scala/org/locationtech/geomesa/cassandra/data/CassandraQueryPlan.scala`
- [File storage](https://github.com/locationtech/geomesa/blob/main/geomesa-fs/geomesa-fs-storage/src/main/scala/org/locationtech/geomesa/fs/storage/core/FileSystemStorage.scala): `geomesa-fs/geomesa-fs-storage/src/main/scala/org/locationtech/geomesa/fs/storage/core/FileSystemStorage.scala`
- [Storage catalog](https://github.com/locationtech/geomesa/blob/main/geomesa-fs/geomesa-fs-storage/src/main/scala/org/locationtech/geomesa/fs/storage/core/StorageCatalog.scala): `geomesa-fs/geomesa-fs-storage/src/main/scala/org/locationtech/geomesa/fs/storage/core/StorageCatalog.scala`
- [In-memory engine](https://github.com/locationtech/geomesa/blob/main/geomesa-memory/geomesa-cqengine/src/main/scala/org/locationtech/geomesa/memory/cqengine/GeoCQEngine.scala): `geomesa-memory/geomesa-cqengine/src/main/scala/org/locationtech/geomesa/memory/cqengine/GeoCQEngine.scala`

### Analytics and formats

- [Kafka streaming](https://github.com/locationtech/geomesa/blob/main/geomesa-kafka/geomesa-kafka-datastore/src/main/scala/org/locationtech/geomesa/kafka/index/KafkaQueryRunner.scala): `geomesa-kafka/geomesa-kafka-datastore/src/main/scala/org/locationtech/geomesa/kafka/index/KafkaQueryRunner.scala`
- [Spark analytics](https://github.com/locationtech/geomesa/blob/main/geomesa-accumulo/geomesa-accumulo-spark/src/main/scala/org/locationtech/geomesa/accumulo/spark/AccumuloSpatialRDDProvider.scala): `geomesa-accumulo/geomesa-accumulo-spark/src/main/scala/org/locationtech/geomesa/accumulo/spark/AccumuloSpatialRDDProvider.scala`
- [Arrow format](https://github.com/locationtech/geomesa/blob/main/geomesa-arrow/geomesa-arrow-gt/src/main/scala/org/locationtech/geomesa/arrow/io/SimpleFeatureArrowFileWriter.scala): `geomesa-arrow/geomesa-arrow-gt/src/main/scala/org/locationtech/geomesa/arrow/io/SimpleFeatureArrowFileWriter.scala`

### Data operations

- [Ingest commands](https://github.com/locationtech/geomesa/blob/main/geomesa-tools/src/main/scala/org/locationtech/geomesa/tools/ingest/IngestCommand.scala): `geomesa-tools/src/main/scala/org/locationtech/geomesa/tools/ingest/IngestCommand.scala`
- [Index writer](https://github.com/locationtech/geomesa/blob/main/geomesa-accumulo/geomesa-accumulo-datastore/src/main/scala/org/locationtech/geomesa/accumulo/data/writer/AccumuloIndexWriter.scala): `geomesa-accumulo/geomesa-accumulo-datastore/src/main/scala/org/locationtech/geomesa/accumulo/data/writer/AccumuloIndexWriter.scala`
- [MapReduce jobs](https://github.com/locationtech/geomesa/blob/main/geomesa-accumulo/geomesa-accumulo-jobs/src/main/scala/org/locationtech/geomesa/accumulo/jobs/index/WriteIndexJob.scala): `geomesa-accumulo/geomesa-accumulo-jobs/src/main/scala/org/locationtech/geomesa/accumulo/jobs/index/WriteIndexJob.scala`

### Other components

- **Users**
- **Mapping clients**

## Connections

- Users → Ingest commands: submit data
- Ingest commands → Accumulo datastore: writes features
- Users → Query planning: request query
- Query planning → Accumulo datastore: plans scan
- Query planning → HBase datastore: plans scan
- Query planning → Cassandra datastore: plans scan
- Query planning → File storage: plans scan
- File storage → Storage catalog: uses catalog (evidence: `geomesa-fs/geomesa-fs-storage/src/main/scala/org/locationtech/geomesa/fs/storage/core/FileSystemStorage.scala`)
- In-memory engine → Filter translation: translates filters (evidence: `geomesa-memory/geomesa-cqengine/src/main/scala/org/locationtech/geomesa/memory/cqengine/GeoCQEngine.scala`)
- Accumulo datastore → Accumulo indexes: uses indexes
- Index writer → Accumulo datastore: writes records
- Backend tools → Accumulo datastore: operates datastore
- Users → Spark analytics: run analytics
- Users → Kafka streaming: stream features
- Query planning → Arrow format: export results
- Query planning → GeoServer integration: serves queries (evidence: `README.md`)
- GeoServer integration → Mapping clients: serves maps (evidence: `README.md`)
- Users → MapReduce jobs: run jobs
