# ThreeJs-TiffTile-Viewer

**Repository Path**: homingfly/ThreeJs-TiffTile-Viewer

## Basic Information

- **Project Name**: ThreeJs-TiffTile-Viewer
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-17
- **Last Updated**: 2025-11-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Microscopy Image Viewer

A Three.js application for visualizing microscopy data with metadata and tiled images.

## Features

- Docker-based setup for cross-platform compatibility
- Upload and parse metadata files (point coordinates)
- Upload and visualize multiple TIFF image tiles
- 3D visualization using Three.js
- Interactive controls for rotating, panning, and zooming

## Requirements

- Docker
- Docker Compose

No local Node.js installation is required as everything runs inside Docker.

## Setup and Running

1. Clone this repository:
   ```
   git clone <repository-url>
   cd microscopy-viewer
   ```

2. Build and run the Docker container:
   ```
   docker-compose up --build
   ```

3. Access the application:
   Open your browser and navigate to `http://localhost:3000`

## Usage

1. Upload Metadata:
   - Click "Choose File" in the "Upload Metadata" section
   - Select your metadata.txt file with point coordinates
   - Click "Upload Metadata"

2. Upload Image Tiles:
   - Click "Choose Files" in the "Upload Image Tiles" section
   - Select your TIFF files (they should have a naming format like *_XY1.tif, *_XY2.tif, etc.)
   - Click "Upload Tiles"

3. Interact with the 3D view:
   - Left-click and drag to rotate
   - Right-click and drag