Git Product home page Git Product logo

dynamovis's Introduction

DynamoVis

test

DynamoVis is a data visualization software specifically targeted for spatiotemporal movement data. It is developed by Move Lab @ UC Santa Barbara and designed to be accessible and easily usable for scientists without extensive prior experience with programming, GIS software, or custom data visualization tools. The intuitive design focuses on a simple interface for scientists to apply spatial data visualization techniques, giving ecologists and biologists of all backgrounds the power to visualize complicated spatial patterns.

Dodge, S., Toka, M. & Bae, C.J. DynamoVis 1.0: an exploratory data visualization software for mapping movement in relation to internal and external factors. Mov Ecol 9, 55 (2021). https://doi.org/10.1186/s40462-021-00291-5

test
- An animation of the user interface using Galapagos Albatross movement data with various basemaps and visualization parameters.

Usage

  1. Make sure to have Java 17 installed and set up in your system or user PATH.

    • To check Java version, start Terminal and type java -version. The version listed should be 17.
  2. Download the latest release (DynamoVis-1.0.2.zip) here.

  3. Unzip the folder anywhere on your machine.

  4. Double-click on DynamoVis.jar

    • If this doesn't do anything:
      • (Windows) Double-click on run_windows.bat
      • (macOS) Start Terminal, type cd (with a white space). Drag and drop the DynamoVis folder on the terminal window and press enter. Type ./run_unix.sh or bash run_unix.shand press enter.
  5. If your system shows a security pop up from an unidentified developer, it is safe to ignore it.

    • (Windows) On the security pop up More info -> Run anyway.
    • (macOS) Click OK on the security pop up to close it. Then go into your System Preferences > Security & Privacy and then click Open Anyway next to the message that DynamoVis.jar was blocked.
  6. The DynamoVis software will open with the initial Input Data and Animation Configuration and Status windows.



Alternatively, you can also run the jar file from Terminal using below command in extracted folder:

 java -jar DynamoVis.jar

See 'Compile from source' section below for notes on compiling the software from scratch.

Use cases

Turkey vulture data set

test
- An exported animation of the turkey vulture Leo on Microsoft Aerial basemap. It shows the foraging behavior of Leo -- moving slowly or pausing in high-vegetation areas (NDVI), shown with bright green circles.


test
- Another exported track animation of turkey vulture Leo displayed on Esri World Terrain basemap. The thicker purple line visualizes thermal uplift that aids the bird to move faster. The thin underlay lines shows the prior movement of Leo, hinting its commonly-travelled routes

Galapagos albatrosses data set

test
test
- An set of exported animations of one Galapagos albatross track (4264-84830852) displayed on Esri World Terrain basemap, illustrating the relationship between the movement speed and wind support. The left visualization highlights the use of higher tail-wind support (shown in blue color) for faster outbound flights (shown with thicker lines), and the right map shows the actual wind direction using vectors of variable size.


test
- Another animation of the albatross (4264-84830852) displayed on the Microsoft Aerial basemap. The visualization highlights the relationship between net primary production (NPP) of the ocean and albatross movement speed. The albatross appears to move slowly (smaller point size) or make frequent stops along the coast of Peru to forage in high NPP areas (shown in darker green colors). The bird appears to fly faster (larger point size) during the flights over the ocean and around the Galapagos where ocean NPP is lower (lighter green colors).

Config

./config/ directory stores extra files that are useful for the use case of the software.

  • RememberedHeaders.txt stores the names of the required fields for DynamoVis to function properly. Upon loading data to the software, the header names of the unique identifier, latitiude, longitude and timestamp will be recorded in this file for future reference. Successive loading of the same file will use information recorded in this file.

  • EnvDATA-variables.csv keeps the details of known fields, commonly used by EnvData system.

  • DiscardedFields.txt hold a list of columns (or fields) in the data that is discarded by DynamoVis. Feel free to add more fields in your local copy to prevent loading unnecessary fields to your animations.

  • ./color/ and ./legend/ folders keeps a copy of the custom color ramps and legend layouts.

BibTex

@article{dodge2021dynamovis,
  title={DynamoVis 1.0: an exploratory data visualization software for mapping movement in relation to internal and external factors},
  author={Dodge, Somayeh and Toka, Mert and Bae, Crystal J},
  journal={Movement Ecology},
  volume={9},
  number={1},
  pages={1--17},
  year={2021},
  publisher={Springer}
}

Data

We distribute copies of Galapagos Albatrosses and Turkey Vultures data sets along with the repository in ./public-data directory.

Project Sponsor

Award BCS # 1853681
PI: Somayeh Dodge

Contact

Feel free to open an issue in case something is wrong. Please make sure to note the description of the issue and your computer specifications (operating system, java version, error messages, etc.).

Compile from source

If you'd like to clone the repository and compile from the source, make sure to have Git Large File System installed and enabled. Git-LFS is required for large *.csv files. If you don't want to install Git-LFS, you will need to clone the repository and manually download .csv files in /config and /public-data.

Tested on:

  • Windows 10
  • Windows 11
  • macOS 10.14.6 Mojave
  • macOS 10.15 Catalina

w/ Java 15.0.2

List of developers

  • Jenni Hutson
  • Mert Toka
  • Glenn Xavier
  • Wing Yi (Pinki) Wong
  • Kate Carlson
  • Kin (Nathan) Chan

dynamovis's People

Contributors

bradh avatar merttoka avatar sonofahutmaker avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar

dynamovis's Issues

Java UnsatisfiedLinkError - is there a solution for Apple Silicon??

java.lang.UnsatisfiedLinkError: Can't load library: /var/folders/ft/r2l5xjqn2dz_x4n3k0h7f6vc0000gq/T/jogamp_0000/file_cache/jln2972385321995133681/jln6713280780942712952/natives/macosx-universal/libgluegen_rt.dylib

Java(TM) SE Runtime Environment (build 17.0.8+9-LTS-211)
Java HotSpot(TM) 64-Bit Server VM (build 17.0.8+9-LTS-211, mixed mode, sharing)

launching DynamoVis with:

java --add-exports java.desktop/com.apple.eawt=ALL-UNNAMED -jar DynamoVis.jar

Any insights?

app won't open mac

I have been trying to open the app following the instructions but it won't open.

Java 15 installed:
/Library/Java/JavaVirtualMachines/jdk-17.0.1.jdk/Contents/Home

Steps to opening it:

  • Double clicked DynamoVis-1.0 nothing opened

  • In terminal I run ./run_unix.sh, it just says 'appending output to nohup.out' then the java icon opens the closes straight away.

  • java -jar DynamoVis-1.0.jar and I get this message:

	at main.DesktopPane.<init>(DesktopPane.java:207)
	at main.DesktopPane$8.run(DesktopPane.java:729)
	at java.desktop/java.awt.event.InvocationEvent.dispatch(InvocationEvent.java:318)
	at java.desktop/java.awt.EventQueue.dispatchEventImpl(EventQueue.java:771)
	at java.desktop/java.awt.EventQueue$4.run(EventQueue.java:722)
	at java.desktop/java.awt.EventQueue$4.run(EventQueue.java:716)
	at java.base/java.security.AccessController.doPrivileged(AccessController.java:399)
	at java.base/java.security.ProtectionDomain$JavaSecurityAccessImpl.doIntersectionPrivilege(ProtectionDomain.java:86)
	at java.desktop/java.awt.EventQueue.dispatchEvent(EventQueue.java:741)
	at java.desktop/java.awt.EventDispatchThread.pumpOneEventForFilters(EventDispatchThread.java:203)
	at java.desktop/java.awt.EventDispatchThread.pumpEventsForFilter(EventDispatchThread.java:124)
	at java.desktop/java.awt.EventDispatchThread.pumpEventsForHierarchy(EventDispatchThread.java:113)
	at java.desktop/java.awt.EventDispatchThread.pumpEvents(EventDispatchThread.java:109)
	at java.desktop/java.awt.EventDispatchThread.pumpEvents(EventDispatchThread.java:101)
	at java.desktop/java.awt.EventDispatchThread.run(EventDispatchThread.java:90)


Any help would be greatly appreciated

Basemap loading

These 3 basemap options don't load for Basemap Provider (all else do):

  • ESRI NatGeo
  • ESRI Ocean Basemap
  • ESRI World Terrain

basemap_noLoad

Input file issue

Hi there.
I got this message while trying to input file. I suppose the issue is somewhere in the input file. I tried to respect the rules for all 4 obligatory fields.

-----New File-----
C:\Users\Emil\Downloads\DynamoVis-1.0\data\Victoria.csv

Using ID as individual-local-identifier
Using Long1(E) as location-long
Using Lat1(N) as location-lat
Using Timestamp as study-local-timestamp
Something bad happened: java.lang.IndexOutOfBoundsException: Index 0 out of bounds for length 0

Many thanks for the help.
Emil

Error with timestamps

Hi,

I am getting an error while setting timestamps. My time column is names "timestamp" and is formatted as dd-mm-yyyy hh:mm:ss.
I get this error in the stats page:
Something bad happened: java.lang.IllegalArgumentException: Invalid pattern specification
I also get a message saying "1" is too short.

I also get this error:
Invalid format: "01-01-2018 02:15" is malformed at "18 02:15"

Could you please help.

Animation Not Loading

Hello,

I have been using DynamoVis for over a year now and up until now, it has worked great. This time, however, after I loaded my data in and clicked on create animation, the animation never loaded. I thought it was my data but I tried some of the sample data that is available when you download the program and the same issue happened. All other aspects of the program appear to be loading but the window where the animation is usually displayed is just a black window. No error pops up in the status window either. I have attached a screenshot of what the problem looks like. I am running Dynamovis 1.0, Windows 11, and Java 15.0.2.

Any help is greatly appreciated. Thanks.

Screenshot (265)

java.lang.NullPointerException: Cannot invoke "java.io.Writer.append(java.lang.CharSequence)" because "output" is null"

Hello,
For me yourTUVU file named Turkey-Vulture-Acopian-Center-USA-GPS-flagged-newUplift-Dec2013.csv produces an error when loaded into the program. The other provided csv file seems to work fine (e.g., albatross-normal-tracks-9track-tailcrosswind.csv) but the 2020 version has the same error (albatross-normal-tracks-9track-tailcrosswind-2020.csv)

I get the same error when I try to load my own data file. I have to fix/match the date format in the process but then when it starts reading again I get the same error as when I try to load your TUVU data set. My goal is to produce something similar to the albatross example you provide where wind support and vectors are shown along with bird movement. Do you have this albatross data set I can use as a test?

The error I get is:
"Individual.local.identifier found
Location.long found
location.lat found
study.local.timestamp found
Timestamp format: yyyy-MM-dd HH:mm:ss.SSS
Something bad happened: java.lang.NullPointerException: Cannot invoke "java.io.Writer.append(java.lang.CharSequence)" because "output" is null"

I'm on a Windows operation system:
Edition Windows 10 Business
Version 21H1
Installed on ‎2/‎26/‎2021
OS build 19043.1586
Experience Windows Feature Experience Pack 120.2212.4170.0

My Java is version "15.0.2" 2021-01-19

No Screen loading after "create animation" on M1 Macbook

Hi everyone.

I wanted to use DynamoVis for my Masters Thesis but so far I don't get the main screen which shows animation and more, only the control panels on both sides.

I run it on a Macbook Pro M1, Mac OS 14.1.1 and Java 22 (also have tried it with 17). Issues appear with my own data and with all included data as well.

Help is highly appreciated!
Thanks in advance and I wish you all the best :)

Bildschirmfoto 2024-04-09 um 11 16 20

visual analytics

Hi,
I do not have the visual analytics tab on my software. I installed from the source mentioned in the movebank website.

Could you please guide on how to activate this option.

Tiles partially disappear

When I zoom in/out a few times across the map, some of the tiles seem to disappear at certain extents.

tiles_partialLoad

Legend saving/loading

After I 'save' a Legend layout and 'load' it again, it adds a blur to the map in that general area of the Legend that doesn't go away even after hitting 'reset'. However, it does seem to resolve itself once I change the map extent again.

legendLoad_blur2

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.