README.md

---
title: Dashboard Prototype
emoji: 👀
colorFrom: pink
colorTo: green
sdk: docker
pinned: false
license: mit
description: >-
  Dashboard for exploring specimen and image metadata, including species information, views, 
  hybrid status, and optional map-based visualization.
tags:
  - dashboard
  - visualization
  - data-explorer
  - metadata
  - mapping
  - geospatial
  - EDA
  - exploration
  - data
  - samples
  - data-visualization
  - evaluation
  - data-exploration
  - visual-analytics
  - animals
  - species
---

<!-- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference -->

# Dashboard Prototype

For development information or to make your own version, see the [GitHub project repo](https://github.com/Imageomics/dashboard-prototype).

## How it works

For full dashboard functionality, upload a CSV or XLS file with the following columns: 
- `Image_filename`*: Filename of each image, must be unique. **Note:** Images should be in PNG or JPEG format, TIFF may fail to render in the sample image display.
- `Species`: Species of each sample.
- `Subspecies`: Subspecies of each sample.
- `View`: View of the sample (eg., 'ventral' or 'dorsal' for butterflies).
- `Sex`: Sex of each sample.
- `hybrid_stat`: Hybrid status of each sample (eg., 'valid_subspecies', 'subspecies_synonym', or 'unknown').
- `lat`*: Latitude at which image was taken or specimen was collected.
- `lon`*: Longitude at which image was taken or specimen was collected.
- `file_url`*: URL to access file.

***Note:** 
- `lat` and `lon` columns are not required to utilize the dashboard, but there will be no map view if they are not included.
- `Image_filename` and `file_url` are not required, but there will be no sample images option if either one is not included.