AtlasEvo
Workspace Guide
AtlasEvo Help & Integration Guide

Connect data to AtlasEvo, work with it in Workspace, and send it where it needs to go

Use this guide when you are connecting a station, vehicle, sensor, file, geospatial service, ocean-data product, API, or downstream system. It explains what AtlasEvo supports directly today, what should come through DataSynch or a gateway, how connectivity choices affect the design, and how to preserve provenance while data moves into and out of Workspace.

🧩 Source🗃️ Dataset🗺️ Layer / records🧭 Analysis📤 Destination
Start here

Choose the path that matches what you have in front of you

You do not need to begin with a protocol name. Begin with the thing you have and the result you need. AtlasEvo can then separate source, protocol, link, transport, representation, Workspace storage, and delivery so each part can change without forcing you to redesign the whole project.

📡 I have a station, sensor, vehicle, or live feed

Use Research onboarding. Describe the platform first, then record the device protocol, the local/network link, and the Atlas-facing access method. Create a Research REST connection only after the station definition is correct and a test observation can be verified.

Connect a station →
🗃️ I have a file, dataset, map service, or research product

Identify the real source and exact representation first. GeoJSON can enter Workspace directly. Other products may be connected or normalized through DataSynch, a source API, or the provider’s tooling before usable records are written into a Workspace dataset.

Find the format or standard →
📤 I need Atlas data somewhere else

Choose whether the recipient needs a one-time export, repeatable DataSynch movement, Research REST access, or a deliberate Crossband share. Keep write-back policy and approved fields explicit when another system can be changed.

Choose a delivery path →
One useful rule: Wi-Fi, cellular, MAVLink, REST, GeoJSON, S-101, and Copernicus Marine are not competing answers to the same question. They live at different layers. A single working integration can use several of them at once.
Architecture

See the whole path before configuring one piece

Observation assets and existing data sources reach Atlas through connectivity and interface layers. AtlasEvo then adds spatial context, ingestion, rules, access controls, and Workspace organization before data is visualized, exported, used by applications, or shared with research and education communities.

Use the architecture as a layer map: identify what your source is, how bytes move, which protocol or data product is involved, how Atlas accesses it, and where the resulting records should go.🔎 Ocean Idea Machine architecture
Stations & live systems

From a physical station or vehicle to live Workspace data

The operational sequence is straightforward even when the hardware is not: identify the platform, establish its position model, describe the connectivity chain, define observations, test the path, and then make the resulting data available in Workspace. The Research wizard groups these jobs into five onboarding stages.

The diagram is an operational sequence, not a claim that every project uses the same hardware or network. Moving platforms can report position with each observation instead of using a fixed location.🔎 How a station joins the network
Connectivity choices

How Wi-Fi, cellular, radio, tether, satellite, and offline links change the integration

Connectivity changes availability, latency, bandwidth, addressing, power use, and whether the source can be reached continuously. It does not change what the observation means. Design a gateway or store-and-forward path that matches the link, then use an Atlas-facing access method that the current project actually supports.

LinkGood fitIntegration impactTypical Atlas pattern
EthernetFixed stations, labs, topside systems, companion computers, tether endpoints.Usually stable and high bandwidth, but physically bounded by the wired network.Run the gateway or source API on the reachable network; expose approved HTTPS/REST or WebSocket access, or feed DataSynch.
Wi-FiLocal station networks, field access points, companion computers, short-range high-bandwidth work.Range, interference, roaming, and changing IP addresses can make direct inbound access unreliable.Prefer outbound HTTPS/WebSocket from a gateway or use a network path that does not require Atlas to discover a changing local device address.
CellularMobile/fixed systems with carrier coverage and Internet access.Coverage, carrier NAT, data plans, roaming, and intermittent handoff matter. Treat loss of service as expected in some operating areas.Use outbound HTTPS/REST, WebSocket, or a store-and-forward gateway. Queue observations locally when coverage drops.
RadioVehicle telemetry, remote sites, private field networks.Bandwidth and reach depend on the actual modem, frequency, topology, and regulatory environment.Terminate radio traffic at a gateway/companion system, then bridge approved data into an Atlas-facing IP transport.
LoRa / LoRaWANSparse sensor telemetry where small payloads and long range matter more than high throughput.Payload size and duty-cycle constraints make it a poor fit for images, video, or high-rate raw telemetry.Send compact observations to a LoRaWAN/network gateway, then forward them to Atlas through an API or DataSynch path.
SatelliteRemote platforms outside terrestrial coverage.Latency, cost, antenna view, power, and service plan can dominate the design.Send prioritized/compact observations through the satellite provider or gateway; use queued batch delivery when continuous streaming is unnecessary.
Acoustic / opticalUnderwater links between UUVs, instruments, gateways, or nearby subsea systems.Underwater bandwidth and reliability can be limited; LTE or ordinary Wi-Fi should not be treated as expected underwater connectivity.Use acoustic/optical data locally, then surface or tether to a gateway that can deliver observations through an Atlas-facing IP/file path.
Physical tetherROVs, UUV test systems, cabled stations, fiber/Ethernet links to topside.The data path can be dependable, but the physical tether becomes part of operations and failure planning.Terminate at topside/companion equipment; from there use Ethernet/IP plus the approved Atlas transport.
Delayed sync / fileExpected-offline field systems, removable media, missions that synchronize after recovery.There is no live path. Timestamp, source identity, units, and provenance become especially important during later reconciliation.Use file upload, cloud/object storage, SFTP or another DataSynch-supported batch path, then write normalized records into the target Workspace dataset.
Do not put third-party credentials in Workspace: configure and verify external transport in DataSynch or the source/gateway system. Workspace stores references, provenance, connection policy, and approved write-back behavior; secrets stay in the server-side connection path.
Getting data into Workspace

Move from source data to records you can actually work with

Workspace is where normalized project records, geometry, layers, source relationships, and derived results become usable together. Preserve the original source and product identity even when the representation is converted before it reaches Workspace.

  1. 1. Create or select the Workspace that represents the real project or operating context.
  2. 2. Add a Source for the real origin: station, provider, agency service, Copernicus product, file collection, API, or partner system.
  3. 3. Create/select the Dataset that should own the usable records. Keep unrelated sources in separate datasets when provenance or refresh behavior differs.
  4. 4. Choose the ingestion path. Use direct GeoJSON import when appropriate; otherwise use Research REST, DataSynch, a source API/toolbox, or a verified connector to normalize records.
  5. 5. Verify time, coordinates, vertical reference, units, observation meaning, source identity, and any standard/profile/version metadata before treating the data as ready.
  6. 6. Create map layers only when a spatial view helps. The dataset remains the record container; a layer is a presentation/organization surface, not the source of truth.
Delivery & downstream use

Choose how approved Atlas data leaves the project

📄 File export

Use the active-dataset export for CSV, GeoJSON, or JSON when a person or external tool needs a point-in-time copy.

🔄 DataSynch

Use DataSynch when records need repeatable movement to APIs, files, databases, cloud storage, notifications, or another enabled connector/destination.

🔌 Research REST

Use the one-time-key Research REST connection for an approved station, application, gateway, or AI workload that needs to send observations through the station’s declared scope.

🤖 MCP / agents

Use Atlasemoji MCP when an approved agent needs scoped access to Atlas capabilities and Workspace context exposed to its credential. The MCP catalog shows the tools and scopes that are currently callable.

🌐 Crossband

Use Crossband when the intent is deliberate community/publication sharing. Research onboarding does not automatically make station geography or observations public.

Agents can return on a schedule: A team can configure the Workspace and integrations once, then let an approved agent return hourly, daily, or on demand through the MCP tools granted to that client. The calling agent or scheduler controls the cadence; Atlas MCP controls which tenant data and capabilities the credential can access.
Write-back is a separate decision: a connection can be source-only, ask before updating, or automatic only when the connector supports destination writes and an explicit approved-field list is configured. Reading a source does not imply permission to change it.
Project structure

The AtlasEvo project model

A Workspace is the AtlasEvo project. The important hierarchy is not “a pile of layers”; it is a traceable chain from source data to usable project output.

Source

Source: where data came from — KoboToolbox, CSV, GeoJSON, an API, a drone survey, a sensor feed, government GIS, or manual work.

Dataset

Dataset: a coherent set of records from a source. A dataset may be spatial, tabular, or mixed.

Layer / records

Layer: the map presentation and organization of spatial records. Not every dataset needs a layer.

Derived result

Derived result: data created by Atlas analysis, such as validated coordinates, geofence membership, routing results, or prioritized findings.

Destination

Destination: where approved results go — remain in AtlasEvo, return to KoboToolbox, move through DataSynch, download as a file, or publish elsewhere.

A project can combine several independent sources while keeping records, analysis, and outputs traceable.🔎 AtlasEvo project model
Workspace controls

Navigation without sacrificing the map

The permanent navigation is intentionally compact. Project and data actions live in menus so controls never consume a large part of the map viewport.

📁 Project

Project menu: create a workspace, manage connections and members, inspect the manifest, open this guide, or delete the project.

ProjectsNew workspaceConnectionsMembersManifestWorkspace Guide
🗃️ Data

Data menu: add a source, create a dataset, create a layer, add data, and export the active dataset.

Add sourceNew datasetNew layerAdd dataCSVGeoJSONJSON
Basemap

Basemap dropdown: switch the geographic reference surface without changing your AtlasEvo data.

2D / 3D

2D / 3D: change camera perspective. Your project data remains the same.

Map context

Choose the right basemap for the work

A basemap is reference context, not your project database. Switching providers does not copy, rewrite, or re-import your AtlasEvo datasets.

Mapbox

Mapbox: strong interactive cartography, terrain, buildings, and Mapbox-specific layer controls.

Google

Google: familiar Google geographic context when that provider is useful for the project.

ArcGIS

ArcGIS: Esri topographic context for GIS and field-project workflows.

OpenStreetMap

OpenStreetMap: open map context for normal interactive project viewing. Standard OSM tiles are not an offline or bulk-download service.

What stays the same: your sources, datasets, record IDs, AtlasEvo layers, properties, connection policies, and analysis lineage. The basemap can change while the project data remains the same project.
Getting data in

How to add and access project data

Start by deciding whether the information is a new independent source or additional records for a source you already created. Then create or select the dataset that should hold the records. Spatial records can be placed into a layer; non-spatial records remain part of the dataset and can still be exported or moved through integrations.

  1. 1. Open Data → Add source and name the real origin, such as “Kobo canal inspections” or “County parcels”.
  2. 2. Select that source and use Data → New dataset for the specific record set you want to manage.
  3. 3. Use Data → Add data for files or geometry, or use Connections/DataSynch when another system should supply the records.
  4. 4. Create a layer when records need a map view. A project can use several layers from the same dataset when different visual organization is useful.
  5. 5. Use the Sources, datasets & layers panel to move through the project hierarchy. Selecting a dataset makes it the active dataset for export and related actions.
  6. 6. Use Data → Export active dataset when you need the records outside AtlasEvo as CSV, GeoJSON, or JSON.
Stations, vehicles & live observations

Configure Research onboarding without mixing protocol, link, and transport

Use Research onboarding for a physical or virtual platform that produces observations over time. The wizard records what the platform is, where it operates, what observations mean, how data moves locally, how Atlas accesses the gateway/source, and what the project may do with the resulting records.

Scenario

Choose the real job first: fixed monitoring, UAV observation, surface/subsurface work, mobile field operations, space/orbital data, or an API/feed scenario.

Platform

Name the platform, choose its type/spatial domain, and describe fixed or telemetry-supplied position and vertical reference.

Integration

Choose source/data profile, device protocol, link, and Atlas-facing transport separately. The current-path summary shows the chain before you save.

Rules & sharing

Add geo-volumes, geo-tethers, expected connectivity behavior, and deliberate sharing/output choices.

Test & launch

Review the configuration, create the station, then create an approved Research REST connection when a gateway/application/AI workload will submit observations.

Required fields vs. values that can come from telemetry

FieldRequired?What to enterWhere to get it
Station / platform nameYesUse a stable human-readable name for the physical platform, virtual feed, or station.Use the project naming convention; keep it stable when hardware is replaced.
Platform typeYesChoose what the thing is operationally: fixed station, UAV, UUV, ROV, USV/vessel, carried sensor, orbital source, virtual/API feed, or another listed type.Choose by the platform itself, not by the protocol or network it uses.
Spatial domainYesChoose subsurface, surface, air/atmosphere, or space.Use the domain where the platform normally operates.
Latitude / longitudeFixed: usually yes. Moving: optional.Enter a fixed/starting WGS84 position when appropriate. Moving platforms can provide position with each observation.Survey/GNSS installation position, autopilot telemetry, or the source API.
Vertical value + referenceWhen vertical position mattersRecord altitude/elevation/depth plus the reference such as MSL, ellipsoid, AGL, local surface, seabed, pressure depth, or local datum.Use the source sensor/autopilot/product documentation. Do not assume all values called “meters” use the same reference.
Sensor / observation typeYes for observation-producing stationsIdentify the phenomenon or observation family: position, temperature, salinity, pressure, depth, current, wind, image/media reference, species observation, or a documented project identifier.Sensor specification, source API variable definition, or data-product documentation.
UnitFor measured quantitiesUse the real source unit and normalize only when the project deliberately chooses a conversion policy.Sensor manual, API metadata, CF variable metadata, or product specification.
Device protocolOnly when one existsSelect MAVLink, NMEA 0183, NMEA 2000, custom serial, or another actual device protocol.Device/autopilot/gateway documentation.
Network / physical linkRecommended for live equipmentRecord Ethernet, Wi-Fi, cellular, radio, LoRa, satellite, acoustic, optical, tether, USB, serial, or the real link in use.How bytes actually move between the device, companion computer, gateway, topside system, and Internet access point.
Atlas transport / accessYes for programmatic ingestionChoose the current Atlas transport/catalog option that reaches the source or gateway. This can be REST/HTTPS even when the vehicle itself speaks MAVLink.Use the Research wizard transport list or a verified DataSynch integration profile.
Before calling the station “live”: verify the station review summary, create the station, create the Research REST connection only when needed, save the one-time key securely, GET the connection endpoint to verify its Connection Card, then POST a real observation from the actual gateway/application and confirm the accepted record appears in the correct Workspace context.
Research REST behavior: the generated endpoint is /api/research/connect/{connectionId}. Authenticate with the one-time Bearer key. GET returns the approved Connection Card. POST accepts one real observation or an observations array (up to the server’s configured request limit) and stores accepted observations for the station. Use the fields returned by the Connection Card and current schema; do not invent capabilities or field names.
Formats, standards & ecosystems

Know what Atlas does directly, what comes through a connector, and what should be preserved as source metadata

The list below deliberately distinguishes file/data representation, device protocol, web service, provider ecosystem, and geospatial product specification. “Covered” does not mean every item is a one-click Workspace parser. Use the support path shown for each family so the instructions match the current product.

Format / standard / ecosystemWhat it isCurrent Atlas pathWhat to do
GeoJSONGeospatial interchange formatWorkspace import/exportImport GeoJSON into the selected Workspace/layer path; preserve feature properties and WGS84 longitude/latitude order. Export active datasets as GeoJSON when another GIS/API needs geometry.
JSON / CSVStructured/tabular interchangeDataSynch / dataset recordsMap real source fields into dataset records through the current file/connector path. Define coordinate, time, units, IDs, and provenance explicitly; export active datasets as JSON or CSV.
NetCDF / CFScientific multidimensional data + metadata conventionsSource tooling / connector → Workspace recordsUse the provider/tooling to select real variables, dimensions, time/depth ranges, units and CF metadata. Normalize the subset into records/layers Atlas can currently store while preserving source dataset/product and CF variable identity.
ZarrChunked N-dimensional array storageSource tooling / connector → Workspace recordsRead/subset the real Zarr store with the provider or compatible tooling. Move only the needed values/geometry/metadata into Workspace; keep the original store URL/product identity and selection provenance.
Raster / vector GISGeospatial data familiesImport/service/connector depends on representationIdentify the exact representation first (GeoJSON, tiles, image/raster product, ArcGIS service, etc.). Do not label an unknown input merely “raster” or “vector” when a concrete service/format is available.
WMS / WMTSOGC map-image / tile servicesReference/map-service pathUse them as map/reference services when appropriate. WMS returns georeferenced map images; WMTS returns predefined tiles. Do not treat either as live sensor telemetry or as equivalent to editable feature records.
OGC API - FeaturesFeature-level web API standardAPI/connector → Workspace datasetDiscover collections/capabilities, query the real feature records, preserve collection/source identity, then map returned features/properties into the Workspace dataset or reference layer needed by the project.
MAVLinkVehicle/robotics messaging protocolDevice/gateway path → Atlas transportRecord MAVLink as the device protocol. Route it over the real serial/radio/Ethernet/Wi-Fi/TCP/UDP path to a companion/gateway, then send approved observation data from that gateway through the Atlas-facing transport.
ArduPilotAutopilot/software ecosystemDevice/gateway path → Atlas transportKeep vehicle control in ArduPilot. Use its MAVLink telemetry and companion-computer integrations to obtain the fields your project needs; translate/forward approved observations rather than turning Atlas into the flight controller.
ArduSubAutopilot/software ecosystemDevice/gateway path → Atlas transportKeep subsea control in ArduSub. Route MAVLink through the companion/topside path, record tether/acoustic/other links separately, and send observation data from the reachable gateway into Atlas.
BlueOSCompanion-computer operating environmentDevice/gateway path → Atlas transportUse BlueOS/companion services to access or route vehicle data. Atlas should receive approved observations/context from the gateway; it does not replace BlueOS vehicle-control responsibilities.
Copernicus MarineOcean-data service and catalogueToolbox/API → selected data → WorkspaceUse the Copernicus Marine Toolbox/catalogue to choose the real product, dataset, variable, time/depth range and representation. Bring the selected subset into Atlas through the applicable connector/record path and preserve product/dataset identifiers.
IHO S-100Hydrographic data-model frameworkProfile metadata + normalized usable contentDo not stop at “S-100” when the product is known. Record the specific S-1xx product and edition, preserve its feature/portrayal/encoding metadata as applicable, and map usable content into Atlas datasets through the project’s real ingestion path.
S-101 ENCS-100 product specificationProfile metadata + normalized usable contentPreserve S-101 product/edition/source identity. Use an S-101-aware source/toolchain to expose the feature content your project needs, then map that content into Atlas without pretending the original ENC is generic GeoJSON.
S-102S-100 product specificationProfile metadata + normalized usable contentPreserve S-102 identity/edition and vertical/bathymetric references. Select the bathymetric surface content needed by the project and normalize it through an appropriate coverage/raster/record workflow.
S-103S-100 product specificationProfile metadata + normalized usable contentPreserve S-103 identity/edition and map only the navigation content actually needed by the project through a compatible source/toolchain.
S-104S-100 product specificationProfile metadata + normalized usable contentPreserve product/edition, time, reference/datum and water-level units. Normalize selected values into project records/observations only after those references are explicit.
S-111S-100 product specificationProfile metadata + normalized usable contentPreserve product/edition, time, units and vector meaning. Move selected current data into a Workspace representation suitable for the project while retaining the original S-111 provenance.
GGDMGeospatial data-model/framework lineageProfile metadata + normalized usable contentTreat GGDM as a geospatial data-model/schema lineage, not a transport. Preserve the supplied profile/version/mapping and transform only the needed feature content into Atlas datasets.
DGIF / DGIMGeospatial data-model/framework lineageProfile metadata + normalized usable contentPreserve the DGIF/DGIM context and any implementation schema/profile supplied by the source. Map usable features/attributes into Atlas without changing the meaning of the external model.
Vendor / standards metadata envelopesSource-specific extension metadataPreserve alongside normalized recordsStore source-specific identifiers, profile/version, variable/product names, and mapping details in extension metadata so Workspace records stay usable without losing the information needed to trace them back to the real source.

Official references

Use the official specification/provider documentation below when implementing the external side of an integration. Atlas documentation explains how to fit the result into AtlasEvo; the standards organizations and vendors define their protocols, formats, products, and services.

Current-support rule: if AtlasEvo does not currently provide a native parser for the original scientific/hydrographic representation, use the provider’s official tooling or an approved connector/gateway to select and normalize the content first. Preserve the original standard/product/profile/version and provenance so conversion does not erase meaning.
Need the field-by-field mapping?

The standards and mapping guide shows how source identifiers, features, geometry, variables, units, time, depth or altitude, product versions, and provenance fit into AtlasEvo records and observations.

Open standards & mapping guide →
Field data

KoboToolbox workflow

Keep collecting in KoboToolbox. AtlasEvo connects those observations to the organization’s actual geography and lets the project decide whether Atlas results should ever be written back.

Field collection stays in KoboToolbox; AtlasEvo combines those records with project geography and controls how results leave the project.🔎 KoboToolbox + AtlasEvo workflow

Values you need from KoboToolbox

FieldRequired?What to enterWhere to get it
Kobo server URLYesUse https://kf.kobotoolbox.org for Global, https://eu.kobotoolbox.org for EU, or your organization’s Kobo server.Use the same KoboToolbox server where the account and project are hosted.
Kobo API KeyYesPaste the exact API Key displayed by KoboToolbox. DataSynch verifies it against Kobo API v2 before the connection is saved.KoboToolbox → profile icon → Account Settings → Security → API Key → Display.
Kobo projectYesAfter Connect succeeds, choose Load Kobo projects and select the project whose submissions Atlas should read.DataSynch lists projects directly from the authenticated Kobo account. The asset UID is shown for each project and can also be entered manually.

How to connect KoboToolbox in DataSynch

FieldRequired?What to enterWhere to get it
Connection nameYesA name your Atlas team will recognize, such as “EU Kobo field inspections”.Choose the name in Atlas. It is not a Kobo credential.
Kobo server URLYesUse https://kf.kobotoolbox.org for Global, https://eu.kobotoolbox.org for EU, or your organization’s Kobo server.Use the same KoboToolbox server where the account and project are hosted.
Kobo API KeyYesPaste the exact API Key displayed by KoboToolbox. DataSynch verifies it against Kobo API v2 before the connection is saved.KoboToolbox → profile icon → Account Settings → Security → API Key → Display.
Kobo projectYesAfter Connect succeeds, choose Load Kobo projects and select the project whose submissions Atlas should read.DataSynch lists projects directly from the authenticated Kobo account. The asset UID is shown for each project and can also be entered manually.
Current Kobo connector scope. The current connector is a source connector: verify the Kobo API Key, list projects, preview submissions, map fields, and queue/import records through DataSynch. Direct Kobo record write-back is not enabled.
Record identity matters. Preserve the external record identity so later refreshes and approved write-back can target the correct source record.
API refresh vs. Kobo REST Services. Kobo REST Services are useful for pushing newly created submissions to another service, but Kobo does not resend that REST payload when a submission is edited. Projects that need edits to stay synchronized should also use API-based refresh/reconciliation.
Analysis

3. Enrich and analyze

Atlas capabilities can operate on project datasets without requiring the source application to become the analysis system.

📍 Locate: normalize and validate places, coordinates, and reference locations.
🛣️ Atlas Vector: work with routes, corridors, centerlines, assignments, and operational geography.
🛰️ Geofencing: determine whether points or movements are inside approved areas and detect entry, exit, or dwell relationships.
🧭 Routing: connect observations, facilities, movement, and project geography.

Store derived results with lineage back to the source records used to create them.

Integrations

4. Connections and write-back

A connection describes how AtlasEvo can exchange data with another system. A connection does not automatically authorize Atlasemoji to change that system.

Never

Never: keep Atlas results separate from the source system.

Ask before updating

Ask before updating: the default for destinations and bidirectional connections. A user approves the update.

Automatic

Automatic: only for intentionally approved fields and workflows.

Movement

AtlasEvo and DataSynch

DataSynch moves and orchestrates data. AtlasEvo stores the project, datasets, layers, provenance, and results. Either side can be the source or destination of a workflow.

📤 AtlasEvo as a DataSynch source

Use AtlasEvo Workspace as a DataSynch source when project datasets should feed another workflow.

📥 AtlasEvo as a DataSynch destination

Use AtlasEvo Workspace as a destination when a connector or workflow should create/update project dataset records.

Access & sharing

How to give people or systems access to the work

Choose the sharing method based on what the recipient needs to do. A collaborator who needs to work inside the project is different from someone who only needs a file or a downstream system that needs structured records.

👤 Project members

Open Project → Members when another Atlasemoji user needs access to the workspace. Workspace roles control whether the person can only view the project or edit/manage it.

📄 Files for people or GIS tools

Use Data → Export active dataset. CSV is useful for tabular review, GeoJSON for spatial tools and GIS workflows, and JSON for full structured records/integration work.

🔌 Connected systems

Use Project → Connections plus DataSynch when another application needs repeatable data movement instead of a one-time file.

🧾 Project structure

Use Project → Manifest when an advanced user or system needs the project structure, IDs, source/dataset summaries, layer relationships, and connection policy references. The manifest is not a credential store.

Traceability

Provenance: know where every record came from

Safe refresh, comparison, and write-back depend on provenance. AtlasEvo assets and records should retain their source, dataset, external identity, import timing, and derived lineage.

🧩

Source and dataset IDs identify the project container.

🔑

External record IDs and versions identify the source-system record.

🕒

Import and source-modified timestamps support refresh and change detection.

🧭

Derived-from references identify which records and operation produced a result.

First project

A practical first project

  1. 1Create a workspace for the real project, not for a single file.
  2. 2Add the first source, for example KoboToolbox field observations.
  3. 3Create a dataset for those observations.
  4. 4Add reference geography such as canals, parcels, facilities, roads, or service areas as a separate source/dataset.
  5. 5Create layers for the spatial views you need.
  6. 6Switch basemaps to choose the best reference context; use 2D or 3D as needed.
  7. 7Run Atlas analysis and keep derived results traceable to their inputs.
  8. 8Review Connections before sending anything back to an external system.
  9. 9Export or route the approved result to the next destination.
Troubleshooting

Troubleshooting

Cannot add geometry: create or select a dataset and layer first.
Mapbox does not load: verify NEXT_PUBLIC_MAPBOX_ACCESS_TOKEN, or switch the Basemap dropdown to ArcGIS/OpenStreetMap while configuring Mapbox.
2D / 3D seems unchanged: confirm the map has finished loading; the top view control now drives the provider camera directly.
Cannot enable automatic write-back: configure explicit writable fields first.
Unsure where data belongs: make it a separate Source when it has an independent origin, credential, refresh cycle, or provenance requirement.
Kobo edits are missing — if the workflow relies on Kobo REST Services, remember that edited submissions are not resent; add API refresh/reconciliation for changes after initial submission.