{"id":22938971,"url":"https://github.com/bigmb/mb_visualize","last_synced_at":"2025-04-01T19:45:12.842Z","repository":{"id":267736763,"uuid":"902180667","full_name":"bigmb/mb_visualize","owner":"bigmb","description":"visualization package of embedidngs in docker/closed environment","archived":false,"fork":false,"pushed_at":"2024-12-12T05:15:45.000Z","size":13,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-07T12:48:54.788Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bigmb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-12T04:15:17.000Z","updated_at":"2024-12-12T05:15:48.000Z","dependencies_parsed_at":"2024-12-12T06:22:07.098Z","dependency_job_id":"42119a70-1901-4eed-8713-2ce67f037df5","html_url":"https://github.com/bigmb/mb_visualize","commit_stats":null,"previous_names":["bigmb/mb_visualize"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigmb%2Fmb_visualize","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigmb%2Fmb_visualize/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigmb%2Fmb_visualize/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigmb%2Fmb_visualize/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bigmb","download_url":"https://codeload.github.com/bigmb/mb_visualize/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246704864,"owners_count":20820632,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-14T12:31:11.454Z","updated_at":"2025-04-01T19:45:12.822Z","avatar_url":"https://github.com/bigmb.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Embedding Visualization Tool\n\nA Docker-based visualization tool for exploring embeddings with associated metadata and images. The tool provides an interactive scatter plot visualization with image display capabilities and metadata exploration.\n\n## Features\n\n- Interactive scatter plot visualization of embeddings\n- Click on points to view associated images\n- Select multiple points to view multiple images\n- Display metadata (image path, date, taxcode) for selected points\n- GUI application for easy file selection and viewer launch\n- Real-time monitoring of new embedding files\n- Docker containerization for easy deployment\n\n## Project Structure\n\n```\n.\n├── data/\n│   ├── embeddings/    # Store embedding JSON files here\n│   └── images/        # Store referenced images here\n├── app.py            # Main Dash application\n├── gui.py            # GUI for file selection and viewer launch\n├── Dockerfile        # Docker container configuration\n├── docker-compose.yml # Docker Compose configuration\n└── requirements.txt  # Python dependencies\n```\n\n## Setup Instructions\n\n1. Install Dependencies:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n2. Docker Setup:\n   - Install Docker and Docker Compose\n   - Ensure Docker daemon is running\n\n## Usage\n\n1. Place your embedding files in the `data/embeddings` directory\n   - Files should be in JSON format with the following structure:\n   ```json\n   {\n     \"embeddings\": [[x1, y1], [x2, y2], ...],\n     \"metadata\": [\n       {\n         \"image\": \"path/to/image.jpg\",\n         \"date\": \"2023-11-20\",\n         \"taxcode\": \"ABC123\"\n       },\n       ...\n     ]\n   }\n   ```\n\n2. Place corresponding images in the `data/images` directory\n\n3. Launch the GUI:\n   ```bash\n   python gui.py\n   ```\n\n4. Using the GUI:\n   - Select an embedding file from the list\n   - Click \"Launch Viewer\" to start the visualization\n   - The viewer will open in your default web browser\n\n5. Interacting with the Visualization:\n   - Click individual points to view the corresponding image\n   - Click and drag to select multiple points\n   - Hover over points to see metadata\n   - Use the plot toolbar for zooming and panning\n\n## Docker Management\n\nManual Docker commands (alternative to GUI):\n\n```bash\n# Build and start the container\ndocker-compose up -d\n\n# Stop the container\ndocker-compose down\n\n# View logs\ndocker-compose logs -f\n```\n\n## Notes\n\n- The GUI automatically monitors the embeddings directory for new files\n- Images are displayed in real-time when points are selected\n- The Docker container mounts the local data directory, so files can be added without rebuilding\n- The viewer runs on port 8050 by default\n\n## Troubleshooting\n\n1. If the viewer doesn't launch:\n   - Check if Docker is running\n   - Ensure port 8050 is available\n   - Check the Docker logs for errors\n\n2. If images don't display:\n   - Verify image paths in the embedding file are correct\n   - Ensure images are present in the data/images directory\n   - Check file permissions\n\n3. For GUI issues:\n   - Restart the GUI application\n   - Check if previous Docker containers are still running\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigmb%2Fmb_visualize","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbigmb%2Fmb_visualize","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigmb%2Fmb_visualize/lists"}