andromeda

A website that enables users to explore high-dimensional image data

https://github.com/imageomics/andromeda

Science Score: 57.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 2 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Academic email domains
  • Institutional organization owner
    Organization imageomics has institutional domain (imageomics.osu.edu)
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (14.3%) to scientific vocabulary
Last synced: 4 months ago · JSON representation

Repository

A website that enables users to explore high-dimensional image data

Basic Info
Statistics
  • Stars: 2
  • Watchers: 10
  • Forks: 1
  • Open Issues: 7
  • Releases: 8
Created almost 3 years ago · Last pushed 11 months ago
Metadata Files
Readme License Citation Zenodo

README.md

Andromeda DOI

Andromeda allows users to visualize high dimensional data in a 2-dimensional plot using weighted multidimensional scaling. Through the interactive interface users can explore the relationships within their data by adjusting the variable weights and viewing an updated plot. Alternatively users can arrange the items in the plot so that Andromeda can determine new variable weights and create a new projection.

This package also includes a page to fetch data from iNaturalist observations and pair them with satellite RGB and landcover data for analysis with Andromeda.

An Andromeda instance allowing users to perform dimensional reduction on an uploaded CSV file can be found on the Imageomics Hugging Face.

sample data visualization in Andromeda

Sample data visualization with Andromeda.

Requirements

Deployment requires Docker.

Development requires python3 and nodejs.

Deployment

Our primary deployment environment is Hugging Face Spaces. To deploy a new version change the version in the tag in the Andromeda Space Dockerfile. Hugging Face handles SSL encryption automatically. Deploying in another environment may require additional configuration; previous configurations are discussed in Prior Configurations.

Development

To run the website locally without using Docker requires two terminal sessions. 1. Python Flask Backend API Server: navigate to the andromeda folder and run bash export ANDROMEDA_DEV_MODE=Y flask --app main run --debug For more information, see the Andromeda Backend README.

  1. Frontend nodejs/react development server: navigate to the andromeda-ui folder and run bash npm run dev For requirements and test information, see the Andromeda UI README.

For instructions on building and running the Docker container see Developing with Docker.

Python Backend

The python backend consists of a Flask REST API server. See the Andromeda Python README for instructions on running locally.

React Frontend

The frontend is a typescript react single page application. The project was generated using nextjs as suggested in the react documentation. See the Andromeda React README for instructions on running locally.

Notebook

An older version of Andromeda written as a jupyter notebook is at Andromeda_IMG.ipynb.

Owner

  • Name: Imageomics Institute
  • Login: Imageomics
  • Kind: organization

GitHub Events

Total
  • Issues event: 6
  • Delete event: 4
  • Issue comment event: 7
  • Push event: 12
  • Pull request review event: 5
  • Pull request event: 10
  • Create event: 6
Last Year
  • Issues event: 6
  • Delete event: 4
  • Issue comment event: 7
  • Push event: 12
  • Pull request review event: 5
  • Pull request event: 10
  • Create event: 6

Issues and Pull Requests

Last synced: 4 months ago

All Time
  • Total issues: 1
  • Total pull requests: 2
  • Average time to close issues: 2 months
  • Average time to close pull requests: 2 days
  • Total issue authors: 1
  • Total pull request authors: 2
  • Average comments per issue: 0.0
  • Average comments per pull request: 0.0
  • Merged pull requests: 1
  • Bot issues: 0
  • Bot pull requests: 1
Past Year
  • Issues: 1
  • Pull requests: 2
  • Average time to close issues: 2 months
  • Average time to close pull requests: 2 days
  • Issue authors: 1
  • Pull request authors: 2
  • Average comments per issue: 0.0
  • Average comments per pull request: 0.0
  • Merged pull requests: 1
  • Bot issues: 0
  • Bot pull requests: 1
Top Authors
Issue Authors
  • johnbradley (8)
  • egrace479 (4)
Pull Request Authors
  • dependabot[bot] (15)
  • johnbradley (10)
  • egrace479 (9)
  • thompsonmj (1)
Top Labels
Issue Labels
documentation (3) interface (3) enhancement (1)
Pull Request Labels
dependencies (16) javascript (12) documentation (7) python (3) bug (1) interface (1)

Dependencies

.github/workflows/python-tests.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
andromeda/Dockerfile docker
  • python 3.11 build
andromeda-ui/Dockerfile docker
  • nginx stable build
  • node 18.16.0 build
andromeda-ui/package-lock.json npm
  • 629 dependencies
andromeda-ui/package.json npm
  • @testing-library/jest-dom ^5.16.5 development
  • @testing-library/react ^14.0.0 development
  • @types/papaparse ^5.3.7 development
  • fetch-mock ^9.11.0 development
  • jest ^29.5.0 development
  • jest-environment-jsdom ^29.5.0 development
  • ts-jest ^29.1.0 development
  • @types/node 18.15.12
  • @types/react 18.0.37
  • @types/react-dom 18.0.11
  • autoprefixer 10.4.14
  • eslint 8.38.0
  • eslint-config-next 13.3.0
  • konva ^9.0.1
  • next 13.3.0
  • papaparse ^5.4.1
  • postcss 8.4.23
  • react 18.2.0
  • react-dom 18.2.0
  • react-konva ^18.2.7
  • react-toastify ^9.1.3
  • tailwindcss 3.3.1
  • typescript 5.0.4
  • use-image ^1.1.0
andromeda/requirements.txt pypi
  • Flask ==2.3.2
  • Flask-Cors ==3.0.10
  • geopandas ==0.13.2
  • pandas ==2.0.0
  • pyinaturalist ==0.18.0
  • scikit-learn ==1.2.2