- Dynamic Situational Awareness
- Detailed documentation
- Quick start
- Prerequisites
- Resources
- Pre-built apps
- Issues
- Troubleshooting
- Contributing
- MDTOC
- Licensing
When the operational landscape changes frequently, then rapid, accurate, purpose-built, mission-focused communication is key to success. This is the working domain of the Dynamic Situational Awareness Open Source App (DSA) built using ArcGIS Runtime. DSA enables physically distributed teams to work as one, maintaining current status on teammates while exploring and illuminating the operational landscape.
DSA is an Open Source App intended and designed for the developer who wants to build their own custom field operation apps. Built using the ArcGIS Runtime SDK for Qt, DSA highlights developer best practices for the specific workflows for in-vehicle (mounted) and field (handheld/dismounted) teams who need to dynamically understand their environment and the situation around them.
The DSA apps do not require access to a server. All the data and processing are on the device itself. Display of each local data source may be toggled on or off. Teammates share information such as own location, observation reports and markup across the peer-to-peer network (UDP). The emphasis is on collaboration with other teammates. These networks are not connected to the Internet, are not high-bandwidth, and are not constantly connected - a situation commonly encountered in field operations. This communication network topology is unlike more traditional ArcGIS Runtime apps that leverage the Internet and web servers for communication or web services for some functionality.
Visit the DSA Open Source App page for more details.
Read the docs for a detailed explanation of the application, including its architecture and how it leverages the ArcGIS platform, as well as how you can begin using the app right away.
The repo contains Qt projects for dynamic situational awareness applications that can be run from within the Qt Creator IDE.
If you just want to grab the latest code and build the project, these are the quick steps:
git clone https://github.com/Esri/dynamic-situational-awareness-qt.gitcd dynamic-situational-awareness-qtgit clone --branch release/100.15 https://github.com/Esri/arcgis-runtime-toolkit-qt.git- Open
DSA.prowith Qt Creator, configure the projects and build.
Note: There is a file path length limit when deploying the DSA apps to Android from Windows. The simplest way to workaround this is to shorten the folder name of the "Shadow Build Directory" in the Qt Creator Project settings.
- ArcGIS Runtime SDK for Qt 100.15
- Qt SDK 5.15.2 or higher
- Qt Creator
- ArcGIS Runtime SDK for Qt C++ Plugin
- For Windows: Microsoft Visual C++ Compiler 14.0
- For more information, please visit the System Requirements page.
Set up the ArcGIS Runtime SDK C++ Toolkit as a build dependency.
# from the base of the repo
git clone --branch release/100.15 https://github.com/Esri/arcgis-runtime-toolkit-qt
The DSA app works with offline data. You can retrieve demo data available for Monterey, California. Details for where to place the data are provided in the demo data's description. Alternatively, you can define your own data by modifying the app's configuration file.
The compiled versions of the DSA app are made available for you to conveniently try out the app, and are not officially supported. Please note that these compiled versions of the app should not be used in production environments.
Find a bug or want to request a new feature? Please let us know by submitting an issue.
DSA now requires additional *.stylx files in the styles/arcade subdirectory of your DSA resource data. The structure
should look like this:
DSA/ResourceData/styles/arcade/mil2525c.stylxDSA/ResourceData/styles/arcade/mil2525d.stylx
To quickly obtain these additional *.stylx files, we provide these in the demo data.
Esri welcomes contributions from anyone and everyone. Please see our guidelines for contributing.
Generating table of contents for documents in this repository was performed using the MDTOC package for Atom.
Copyright 2018 Esri
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
A copy of the license is available in the repository's LICENSE file