Skip to content

OpenAthena allows common drones to spot precise geodetic locations

License

Notifications You must be signed in to change notification settings

combat-networks/OpenAthenaAndroid

 
 

Repository files navigation

OpenAthena™ for Android

OpenAthena for Android

An Android port of the OpenAthena project

OpenAthena™ allows consumer and professional drones to spot precise geodetic locations

🖼️👨‍💻 + 🧮⛰️ = 🎯📍

OpenAthena Drone Camera Terrain Raycast Concept Diagram

OpenAthena Android splash screen demo

OpenAthena™ Android Target Calculation demo using cobb.tif and DJI_0419.JPG, output mode WGS84

OpenAthena Android DJI_0419.JPG target shown in Google Maps satellite view

OpenAthena for Android triggers a waypoint to show in Android Team Awarness Kit at the calculated location

Get it on Google Play

Operation Guide

Obtain a GeoTIFF Digital Elevation Model:

Use of this app requires loading a GeoTIFF Digital Elevation Model (DEM) file, stored as a GeoTIFF ".tif" file.

GeoTIFF files store terrain elevation (height) for an area of the Earth. OpenAthena™ performs a ray-cast from a drone camera's position and orientation towards terrain. This may be used to precisely locate any arbitrary point within a given picture.

For information on how to clip a GeoTIFF file of a customized area, see this link.

Load a GeoTIFF Digital Elevation Model ⛰:

Load the DEM file, e.g. cobb.tif using the " ⛰" button (NOTE: during file selection, the thumbnail image preview for any GeoTIFF ".tif" file will be blank. This is normal.), and the app will display the size of the file as well as its Latitude and Longitude boundaries:

OpenAthena™ Android GeoTIFF DEM loading demo using cobb.tif

Select an Image 🖼:

This app is compatible with images taken by select models of DJI, Skydio, Autel, and Parrot aircraft. The drone's position and its camera's orientation are automatically extracted from metadata embeded within the image.

After loading a GeoTIFF DEM using the " ⛰" button (see section above), use the "🖼" button to select a drone image containing the necessary metadata:

OpenAthena™ Android Image Selection demo using DJI_0419.JPG

Calculate a target 🧮 🎯:

Then, press the "🧮" button to calculate the target location on the ground:

OpenAthena™ Android Target Calculation demo using cobb.tif and DJI_0419.JPG, output mode WGS84

You can now tap on the result display box to copy the result text to your clipboard:

OpenAthena Android DJI_0419.JPG target location text copied to clipboard

Alternatively, you may open the position in the Google Maps app by cliking on the blue hyperlink:

OpenAthena Android DJI_0419.JPG target shown in Google Maps satellite view

ATAK Cursor on Target

When the "🧮" button is pressed, OpenAthena will automatically send a multicast packet to udp://239.2.3.1:6969 . Under default settings, this will cause a marker to show up in ATAK at the target location:

OpenAthena for Android triggers a waypoint to show in Android Team Awarness Kit at the calculated location

Change the marker to its appropriate type (friend, suspect, hostile) then send the target to other networked users.

Arbitrary Point Selection

OpenAthena for Android allows the user to tap any arbitrary point in the image to locate it.

Tapping on any point in the image will move the marker and calculate the new location:

OpenAthena for Android demo of arbitrary point selection for raycast calculation

A new Cursor-on-Target message will not be sent to ATAK however until the "🧮" button is pressed:

OpenAthena for Android demo of a cursor on target message calculated for an arbitrary point selected in a drone image

Application Settings (optional) ⚙:

OpenAthena for Android supports multiple output modes for target calculation, including:

To change the ouptut mode of OpenAthena for Android, tap the kebab menu icon (three dots) at the top-right corner of the screen and select "Settings":

OpenAthena™ Android Open Settings Activity demo

You will be taken to a new screen showing a list of possible output modes:

OpenAthena™ Android 🎯 Output Modes Activity demo WGS84

Select your desired output mode by pressing its button in the list:

OpenAthena™ Android 🎯 Output Modes Activity demo NATO MGRS 10m

Then press the back button or again tap the kebab menu icon (three dots) to return to the "Calculate" screen.

Finally, press the "🧮" button to re-calculate the target location according to your chosen output mode:

OpenAthena™ Android Target Calculation demo using cobb.tif and DJI_0419.JPG, output mode NATO MGRS 10m

LIVE Telemetry from DJI-SDK

TBD

Contributing

UI language translation

If you speak another language in addition to English, please consider contributing to the UI translation using the link below. The insights of a native-speaker are the only way to provide a good user experience for the program in a given language:

https://www.transifex.com/krupczakorg/openathena-for-android/

Code

If you're interested in contributing to this project, feel free to make a fork. This project will follow the fork and pull model for third-party contributors

About

OpenAthena allows common drones to spot precise geodetic locations

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Java 99.7%
  • HTML 0.3%