Skip to content

Conversation

rdhyee
Copy link
Contributor

@rdhyee rdhyee commented Aug 28, 2025

No description provided.

rdhyee and others added 2 commits August 21, 2025 14:28
This commit addresses the unavailability of iSamples Central by migrating the entire
website to a modern, browser-based geoparquet approach for data access and analysis.

## Key Changes

### Navigation & UI Updates
- Remove iSamples Central table tool from sidebar navigation (_quarto.yml)
- Eliminate dependencies on unavailable Central API endpoints

### Content Migration
- **Homepage (index.qmd)**: Add prominent geoparquet transition notice with benefits
- **About page (about.qmd)**: Update project objectives and explain current data access model
- **Tutorials overview (tutorials/index.qmd)**: Complete rewrite showcasing browser-based analysis capabilities
- **Requirements (design/requirements.md)**: Update data synchronization model for distributed approach

### Technical Improvements
- Replace server-dependent API calls with HTTP range requests on parquet files
- Transition from centralized to universal browser-based data access
- Maintain complete functionality while achieving significant performance gains

## Benefits Delivered

### User Experience
✅ Universal browser access without software installation requirements
✅ 5-10x faster analysis with 99% reduction in data transfer
✅ Complete dataset coverage from all iSamples sources (SESAR, OpenContext, GEOME, Smithsonian)
✅ Real-time interactive exploration and visualization capabilities

### Available Data Sources
- Zenodo complete dataset (~300MB, 6+ million records)
- OpenContext archaeological collections
- Domain-specific parquet files for focused analysis
- All existing tutorial functionality enhanced and preserved

This migration ensures continued comprehensive sample data access with improved
reliability, performance, and accessibility characteristics while maintaining
the core mission of the iSamples project.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
@rdhyee rdhyee requested a review from Copilot August 28, 2025 15:49
Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR updates the iSamples documentation to reflect the current unavailability of iSamples Central and the transition to geoparquet-based data access. The changes emphasize the new browser-based analysis approach using DuckDB-WASM and parquet files.

Key changes:

  • Replaces API-focused content with geoparquet-based tutorial information
  • Adds prominent notices about iSamples Central being unavailable
  • Updates architectural references to reflect the new distributed data approach

Reviewed Changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
tutorials/index.qmd Complete overhaul from API tutorial to geoparquet-focused content with tutorial categories
index.qmd Adds notice about Central unavailability and highlights new geoparquet approach
design/requirements.md Updates synchronization strategy to reflect parquet-based approach
about.qmd Adds current data access section explaining the transition
_quarto.yml Removes link to unavailable iSamples Central UI
.claude/settings.local.json Adds new configuration file for git permissions

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

rdhyee and others added 2 commits August 28, 2025 08:51
saying where the 5-10x faster claim comes from

Co-authored-by: Copilot <[email protected]>
useful to back off from quantitative claims

Co-authored-by: Copilot <[email protected]>
@rdhyee rdhyee merged commit 97a7606 into isamplesorg:main Aug 28, 2025
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant