cesiumjs-anywidget 0.5.0__tar.gz → 0.7.0__tar.gz

{cesiumjs_anywidget-0.5.0 → cesiumjs_anywidget-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cesiumjs-anywidget
-Version: 0.5.0
+Version: 0.7.0
 Summary: A Jupyter widget for CesiumJS 3D globe visualization using anywidget
 Project-URL: Homepage, https://github.com/Alex-PLACET/cesiumjs_anywidget
 Project-URL: Repository, https://github.com/Alex-PLACET/cesiumjs_anywidget
@@ -213,19 +213,28 @@ Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.8
+Requires-Python: >=3.12
 Requires-Dist: anywidget>=0.9.0
+Requires-Dist: exifread>=3.5.1
+Requires-Dist: ipycanvas>=0.14.3
+Requires-Dist: jupyterlab>=4.3.8
+Requires-Dist: matplotlib>=3.7.5
+Requires-Dist: numpy>=1.24.4
+Requires-Dist: opencv-python>=4.11.0.86
+Requires-Dist: pillow>=10.4.0
+Requires-Dist: pygeodesy>=25.11.5
+Requires-Dist: scipy>=1.10.1
 Requires-Dist: traitlets>=5.0.0
 Provides-Extra: dev
+Requires-Dist: huggingface-hub>=1.3.4; extra == 'dev'
 Requires-Dist: jupyterlab>=4.0.0; extra == 'dev'
 Requires-Dist: notebook>=7.0.0; extra == 'dev'
+Requires-Dist: piexif>=1.1.3; extra == 'dev'
+Requires-Dist: pyarrow>=23.0.0; extra == 'dev'
 Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
 Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: sidecar>=0.8.0; extra == 'dev'
 Description-Content-Type: text/markdown
 
 # CesiumJS Anywidget
@@ -239,6 +248,7 @@ A Jupyter widget for interactive 3D globe visualization using [CesiumJS](https:/
 - 🔄 **Bidirectional Sync**: Camera state syncs between Python and JavaScript
 - 🗺️ **GeoJSON Support**: Load and visualize GeoJSON data
 - 🏔️ **Terrain & Imagery**: World terrain and satellite imagery
+- 🏙️ **Photorealistic 3D Tiles**: Google's photorealistic global 3D cities and landscapes
 - 📏 **Measurement Tools**: Built-in distance, multi-point, and height measurement tools
 - ⚙️ **Highly Configurable**: Customize viewer options and UI elements
 
@@ -393,6 +403,35 @@ widget = CesiumWidget(
 )
 ```
 
+### Google Photorealistic 3D Tiles
+
+Visualize cities and landscapes in stunning photorealistic detail using Google's Photorealistic 3D Tiles:
+
+```python
+# Enable photorealistic tiles (recommended method)
+widget = CesiumWidget()
+widget.enable_photorealistic_3d_tiles(True)
+
+# Fly to a city to see the tiles
+widget.fly_to(latitude=40.7128, longitude=-74.0060, altitude=2000, pitch=-45)
+
+# Or configure manually during creation
+widget = CesiumWidget(
+    enable_photorealistic_tiles=True,
+    show_globe=False,  # Disable base globe (recommended)
+    enable_terrain=False,  # Disable terrain (tiles include terrain)
+    height="700px"
+)
+```
+
+**Features:**
+- Global coverage of major cities and populated areas
+- Photorealistic imagery with 3D buildings and structures
+- Automatic terrain integration
+- Works with all camera controls and measurement tools
+
+See [PHOTOREALISTIC_TILES.md](PHOTOREALISTIC_TILES.md) for detailed documentation and [examples/photorealistic_tiles_demo.ipynb](examples/photorealistic_tiles_demo.ipynb) for interactive examples.
+
 ## Development
 
 Enable hot module replacement for live updates during development:

{cesiumjs_anywidget-0.5.0 → cesiumjs_anywidget-0.7.0}/README.md

@@ -9,6 +9,7 @@ A Jupyter widget for interactive 3D globe visualization using [CesiumJS](https:/
 - 🔄 **Bidirectional Sync**: Camera state syncs between Python and JavaScript
 - 🗺️ **GeoJSON Support**: Load and visualize GeoJSON data
 - 🏔️ **Terrain & Imagery**: World terrain and satellite imagery
+- 🏙️ **Photorealistic 3D Tiles**: Google's photorealistic global 3D cities and landscapes
 - 📏 **Measurement Tools**: Built-in distance, multi-point, and height measurement tools
 - ⚙️ **Highly Configurable**: Customize viewer options and UI elements
 
@@ -163,6 +164,35 @@ widget = CesiumWidget(
 )
 ```
 
+### Google Photorealistic 3D Tiles
+
+Visualize cities and landscapes in stunning photorealistic detail using Google's Photorealistic 3D Tiles:
+
+```python
+# Enable photorealistic tiles (recommended method)
+widget = CesiumWidget()
+widget.enable_photorealistic_3d_tiles(True)
+
+# Fly to a city to see the tiles
+widget.fly_to(latitude=40.7128, longitude=-74.0060, altitude=2000, pitch=-45)
+
+# Or configure manually during creation
+widget = CesiumWidget(
+    enable_photorealistic_tiles=True,
+    show_globe=False,  # Disable base globe (recommended)
+    enable_terrain=False,  # Disable terrain (tiles include terrain)
+    height="700px"
+)
+```
+
+**Features:**
+- Global coverage of major cities and populated areas
+- Photorealistic imagery with 3D buildings and structures
+- Automatic terrain integration
+- Works with all camera controls and measurement tools
+
+See [PHOTOREALISTIC_TILES.md](PHOTOREALISTIC_TILES.md) for detailed documentation and [examples/photorealistic_tiles_demo.ipynb](examples/photorealistic_tiles_demo.ipynb) for interactive examples.
+
 ## Development
 
 Enable hot module replacement for live updates during development:

cesiumjs_anywidget-0.7.0/jest.config.js

@@ -0,0 +1,18 @@
+export default {
+  testEnvironment: 'jsdom',
+  testMatch: ['**/tests/js/**/*.test.js'],
+  transform: {},
+  moduleNameMapper: {
+    '\\.(css|less|scss|sass)$': '<rootDir>/tests/js/__mocks__/styleMock.js',
+  },
+  setupFilesAfterEnv: ['<rootDir>/tests/js/setup.js'],
+  collectCoverageFrom: [
+    'src/cesiumjs_anywidget/js/**/*.js',
+    '!src/cesiumjs_anywidget/js/index.js', // Skip main entry point for now
+  ],
+  coverageDirectory: 'coverage',
+  coverageReporters: ['text', 'lcov', 'html'],
+  verbose: true,
+  testPathIgnorePatterns: ['/node_modules/', '/.venv/', '/htmlcov/'],
+  modulePathIgnorePatterns: ['<rootDir>/.venv/', '<rootDir>/htmlcov/'],
+};

cesiumjs_anywidget-0.7.0/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "cesiumjs-anywidget",
+  "version": "0.1.0",
+  "description": "A Jupyter widget for CesiumJS 3D globe visualization",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "node build.js",
+    "watch": "node build.js --watch",
+    "dev": "node build.js --watch",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "test:watch": "node --experimental-vm-modules node_modules/jest/bin/jest.js --watch",
+    "test:coverage": "node --experimental-vm-modules node_modules/jest/bin/jest.js --coverage"
+  },
+  "devDependencies": {
+    "@jest/globals": "^29.7.0",
+    "esbuild": "^0.27.1",
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0"
+  }
+}

{cesiumjs_anywidget-0.5.0 → cesiumjs_anywidget-0.7.0}/pyproject.toml

@@ -4,14 +4,14 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cesiumjs-anywidget"
-version = "0.5.0"
+version = "0.7.0"
 description = "A Jupyter widget for CesiumJS 3D globe visualization using anywidget"
 readme = "README.md"
 license = { file = "LICENSE" }
 authors = [
     { name = "Alexis Placet" }
 ]
-requires-python = ">=3.8"
+requires-python = ">=3.12"
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Framework :: Jupyter",
@@ -19,14 +19,19 @@ classifiers = [
     "Intended Audience :: Science/Research",
     "License :: OSI Approved :: Apache Software License",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
-    "Programming Language :: Python :: 3.9",
-    "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
 ]
 dependencies = [
     "anywidget>=0.9.0",
+    "exifread>=3.5.1",
+    "ipycanvas>=0.14.3",
+    "jupyterlab>=4.3.8",
+    "matplotlib>=3.7.5",
+    "numpy>=1.24.4",
+    "opencv-python>=4.11.0.86",
+    "pillow>=10.4.0",
+    "pygeodesy>=25.11.5",
+    "scipy>=1.10.1",
     "traitlets>=5.0.0",
 ]
 
@@ -34,8 +39,12 @@ dependencies = [
 dev = [
     "jupyterlab>=4.0.0",
     "notebook>=7.0.0",
+    "piexif>=1.1.3",
     "pytest>=7.0.0",
     "pytest-cov>=4.0.0",
+    "pyarrow>=23.0.0",
+    "huggingface_hub>=1.3.4",
+    "sidecar>=0.8.0",
 ]
 
 [project.urls]

cesiumjs_anywidget-0.7.0/src/cesiumjs_anywidget/__init__.py

@@ -0,0 +1,27 @@
+"""CesiumJS Anywidget - A Jupyter widget for CesiumJS 3D globe visualization."""
+
+from .widget import CesiumWidget
+from .geoid import (
+    get_geoid_undulation,
+    msl_to_wgs84,
+    wgs84_to_msl,
+    clear_geoid_cache,
+    set_geoid_data_url,
+)
+from .logger import get_logger, set_log_level
+from .exif_utils import extract_all_metadata, extract_gps_data, extract_datetime
+
+__version__ = "0.6.0"
+__all__ = [
+    "CesiumWidget",
+    "get_geoid_undulation",
+    "msl_to_wgs84",
+    "wgs84_to_msl",
+    "clear_geoid_cache",
+    "set_geoid_data_url",
+    "get_logger",
+    "set_log_level",
+    "extract_all_metadata",
+    "extract_gps_data",
+    "extract_datetime",
+]

cesiumjs_anywidget-0.7.0/src/cesiumjs_anywidget/exif_utils.py

@@ -0,0 +1,281 @@
+"""EXIF data extraction utilities for photo geolocation."""
+
+import exifread
+from datetime import datetime
+from typing import Optional, Dict, Any, Tuple
+from pathlib import Path
+from .logger import get_logger
+
+logger = get_logger(__name__)
+
+
+def _convert_to_degrees(value) -> float:
+    """Convert GPS coordinates to degrees.
+    
+    Parameters
+    ----------
+    value : exifread.utils.Ratio list
+        GPS coordinate in degrees, minutes, seconds format
+        
+    Returns
+    -------
+    float
+        Coordinate in decimal degrees
+    """
+    d = float(value.values[0].num) / float(value.values[0].den)
+    m = float(value.values[1].num) / float(value.values[1].den)
+    s = float(value.values[2].num) / float(value.values[2].den)
+
+    # Normalize malformed DMS values from some writers
+    # Some encoders store seconds as total arc-seconds * 60 (e.g., 1425 instead of 23.75)
+    if s >= 60 and m < 60:
+        s = s / 60.0
+
+    if s >= 60:
+        carry = int(s // 60)
+        s = s - (carry * 60)
+        m += carry
+
+    if m >= 60:
+        carry = int(m // 60)
+        m = m - (carry * 60)
+        d += carry
+
+    return d + (m / 60.0) + (s / 3600.0)
+
+
+def extract_gps_data(image_path: str) -> Optional[Dict[str, float]]:
+    """Extract GPS coordinates from image EXIF data.
+    
+    Parameters
+    ----------
+    image_path : str
+        Path to the image file
+        
+    Returns
+    -------
+    dict or None
+        Dictionary containing 'latitude', 'longitude', and optionally 'altitude'
+        Returns None if GPS data is not available
+        
+    Examples
+    --------
+    >>> gps_data = extract_gps_data('photo.jpg')
+    >>> if gps_data:
+    ...     print(f"Location: {gps_data['latitude']}, {gps_data['longitude']}")
+    """
+    try:
+        with open(image_path, 'rb') as f:
+            tags = exifread.process_file(f, details=False)
+        
+        # Check if GPS data exists
+        if 'GPS GPSLatitude' not in tags or 'GPS GPSLongitude' not in tags:
+            logger.warning(f"No GPS data found in {image_path}")
+            return None
+        
+        # Extract latitude
+        lat = _convert_to_degrees(tags['GPS GPSLatitude'])
+        if tags.get('GPS GPSLatitudeRef', 'N').values[0] == 'S':
+            lat = -lat
+        
+        # Extract longitude
+        lon = _convert_to_degrees(tags['GPS GPSLongitude'])
+        if tags.get('GPS GPSLongitudeRef', 'E').values[0] == 'W':
+            lon = -lon
+        
+        result = {
+            'latitude': lat,
+            'longitude': lon,
+        }
+        
+        # Extract altitude if available
+        if 'GPS GPSAltitude' in tags:
+            alt_tag = tags['GPS GPSAltitude']
+            altitude = float(alt_tag.values[0].num) / float(alt_tag.values[0].den)
+            
+            # Check altitude reference (0 = above sea level, 1 = below sea level)
+            if 'GPS GPSAltitudeRef' in tags:
+                alt_ref = tags['GPS GPSAltitudeRef'].values[0]
+                if alt_ref == 1:
+                    altitude = -altitude
+            
+            result['altitude'] = altitude
+        
+        logger.info(f"Extracted GPS data from {image_path}: {result}")
+        return result
+        
+    except Exception as e:
+        logger.error(f"Error extracting GPS data from {image_path}: {e}")
+        return None
+
+
+def extract_datetime(image_path: str) -> Optional[datetime]:
+    """Extract capture datetime from image EXIF data.
+    
+    Parameters
+    ----------
+    image_path : str
+        Path to the image file
+        
+    Returns
+    -------
+    datetime or None
+        Image capture datetime, or None if not available
+        
+    Examples
+    --------
+    >>> dt = extract_datetime('photo.jpg')
+    >>> if dt:
+    ...     print(f"Captured on: {dt.strftime('%Y-%m-%d %H:%M:%S')}")
+    """
+    try:
+        with open(image_path, 'rb') as f:
+            tags = exifread.process_file(f, details=False)
+        
+        # Try different datetime tags
+        for tag_name in ['EXIF DateTimeOriginal', 'EXIF DateTime', 'Image DateTime']:
+            if tag_name in tags:
+                dt_str = str(tags[tag_name])
+                # Parse datetime (format: "YYYY:MM:DD HH:MM:SS")
+                dt = datetime.strptime(dt_str, '%Y:%m:%d %H:%M:%S')
+                logger.info(f"Extracted datetime from {image_path}: {dt}")
+                return dt
+        
+        logger.warning(f"No datetime found in {image_path}")
+        return None
+        
+    except Exception as e:
+        logger.error(f"Error extracting datetime from {image_path}: {e}")
+        return None
+
+
+def extract_camera_info(image_path: str) -> Dict[str, Any]:
+    """Extract camera information from image EXIF data.
+    
+    Parameters
+    ----------
+    image_path : str
+        Path to the image file
+        
+    Returns
+    -------
+    dict
+        Dictionary containing camera make, model, focal length, sensor size, etc.
+        
+    Examples
+    --------
+    >>> info = extract_camera_info('photo.jpg')
+    >>> print(f"Camera: {info.get('make')} {info.get('model')}")
+    """
+    result = {}
+    
+    try:
+        with open(image_path, 'rb') as f:
+            tags = exifread.process_file(f, details=False)
+        
+        # Camera make and model
+        if 'Image Make' in tags:
+            result['make'] = str(tags['Image Make'])
+        if 'Image Model' in tags:
+            result['model'] = str(tags['Image Model'])
+        
+        # Focal length
+        if 'EXIF FocalLength' in tags:
+            focal_tag = tags['EXIF FocalLength']
+            focal_length = float(focal_tag.values[0].num) / float(focal_tag.values[0].den)
+            result['focal_length_mm'] = focal_length
+        
+        # Focal length in 35mm equivalent
+        if 'EXIF FocalLengthIn35mmFilm' in tags:
+            result['focal_length_35mm'] = int(tags['EXIF FocalLengthIn35mmFilm'].values[0])
+        
+        # Image dimensions
+        if 'EXIF ExifImageWidth' in tags:
+            result['image_width'] = int(tags['EXIF ExifImageWidth'].values[0])
+        if 'EXIF ExifImageLength' in tags:
+            result['image_height'] = int(tags['EXIF ExifImageLength'].values[0])
+        
+        # Orientation
+        if 'Image Orientation' in tags:
+            result['orientation'] = str(tags['Image Orientation'])
+        
+        logger.info(f"Extracted camera info from {image_path}: {result}")
+        return result
+        
+    except Exception as e:
+        logger.error(f"Error extracting camera info from {image_path}: {e}")
+        return result
+
+
+def get_image_dimensions(image_path: str) -> Optional[Tuple[int, int]]:
+    """Get image dimensions (width, height) from file.
+    
+    Parameters
+    ----------
+    image_path : str
+        Path to the image file
+        
+    Returns
+    -------
+    tuple or None
+        (width, height) in pixels, or None if unable to read
+    """
+    try:
+        from PIL import Image
+        with Image.open(image_path) as img:
+            return img.size
+    except Exception as e:
+        logger.error(f"Error reading image dimensions from {image_path}: {e}")
+        return None
+
+
+def extract_all_metadata(image_path: str) -> Dict[str, Any]:
+    """Extract all relevant metadata from an image.
+    
+    Combines GPS, datetime, camera info, and image dimensions into one dictionary.
+    
+    Parameters
+    ----------
+    image_path : str
+        Path to the image file
+        
+    Returns
+    -------
+    dict
+        Dictionary containing all extracted metadata
+        
+    Examples
+    --------
+    >>> metadata = extract_all_metadata('photo.jpg')
+    >>> print(metadata)
+    {'latitude': 48.8566, 'longitude': 2.3522, 'altitude': 100,
+     'datetime': datetime(2024, 1, 15, 14, 30, 0),
+     'make': 'Canon', 'model': 'EOS R5', ...}
+    """
+    metadata = {
+        'file_path': str(Path(image_path).absolute()),
+        'file_name': Path(image_path).name,
+    }
+    
+    # GPS data
+    gps_data = extract_gps_data(image_path)
+    if gps_data:
+        metadata.update(gps_data)
+    
+    # Datetime
+    dt = extract_datetime(image_path)
+    if dt:
+        metadata['datetime'] = dt
+        metadata['datetime_str'] = dt.isoformat()
+    
+    # Camera info
+    camera_info = extract_camera_info(image_path)
+    metadata.update(camera_info)
+    
+    # Image dimensions
+    dims = get_image_dimensions(image_path)
+    if dims:
+        metadata['width'] = dims[0]
+        metadata['height'] = dims[1]
+    
+    return metadata