Adding configurable base layers, including adding wms options for moon and mars

app/js/components/inference/app-map.js

@@ -223,9 +223,70 @@ window.customElements.define(
       this.attribution = mapConfig.attribution;
     }
 
+    /**
+     * Switch the base layer based on celestial body
+     * @param {string} celestialBody - 'earth', 'moon', or 'mars'
+     */
+    switchBaseLayer(celestialBody) {
+      if (!this.map || !celestialBody) return;
+
+      // Normalize to lowercase
+      const targetBody = celestialBody.toLowerCase();
+
+      // Don't switch if already on the correct base layer
+      if (this.currentBaseLayer === targetBody) return;
+
+      const viewer = this.map;
+      const imageryLayers = viewer.imageryLayers;
+
+      // Get the base layer (always at index 0)
+      const baseLayer = imageryLayers.get(0);
+
+      if (!baseLayer) return;
+
+      // Determine which provider to use
+      let newProvider = null;
+
+      switch(targetBody) {
+        case 'moon':
+          newProvider = this.celestialBodyProviders.moon;
+          console.log('Switching to Moon base layer');
+          break;
+        case 'mars':
+          newProvider = this.celestialBodyProviders.mars;
+          console.log('Switching to Mars base layer');
+          break;
+        case 'earth':
+        default:
+          // For Earth, we don't need to do anything as it's the default
+          // User can manually select Earth layers from the base layer picker
+          console.log('Switching to Earth base layer (use base layer picker for specific Earth imagery)');
+          this.currentBaseLayer = 'earth';
+          return;
+      }
+
+      if (newProvider) {
+        // Remove the current base layer
+        imageryLayers.remove(baseLayer, false);
+
+        // Add the new base layer at index 0
+        const newLayer = imageryLayers.addImageryProvider(newProvider, 0);
+
+        // Update current base layer tracking
+        this.currentBaseLayer = targetBody;
+
+        console.log(`Base layer switched to: ${targetBody}`);
+      }
+    }
+
     addWMSLayer(layerData) {
       if (!this.map) throw new Error("Please call loadMap() first");
 
+      // Check if layer specifies a base layer (celestial body) and switch if needed
+      if (layerData.baseLayer) {
+        this.switchBaseLayer(layerData.baseLayer);
+      }
+
       // lookup CRS
       if (layerData.params.crs !== undefined) {
         switch (layerData.params.crs) {
@@ -1090,6 +1151,50 @@ window.customElements.define(
         );
       }
 
+      // Moon WMS Provider
+      const moonWmsProvider = new Cesium.WebMapServiceImageryProvider({
+        url: 'https://wms.im-ldi.com/',
+        layers: 'luna_wac_global',
+        parameters: {
+          service: 'WMS',
+          format: 'image/png',
+          transparent: false,
+          crs: 'EPSG:3857',
+          dpiMode: 7
+        },
+        tilingScheme: new Cesium.WebMercatorTilingScheme()
+      });
+
+      const moonViewModel = new Cesium.ProviderViewModel({
+        name: 'Moon (Lunar WAC)',
+        iconUrl: Cesium.buildModuleUrl('Assets/Textures/moonSmall.jpg'),
+        tooltip: 'Lunar Reconnaissance Orbiter Wide Angle Camera Global Mosaic',
+        category: 'Celestial Bodies',
+        creationFunction: () => moonWmsProvider
+      });
+
+      // Mars WMS Provider
+      const marsWmsProvider = new Cesium.WebMapServiceImageryProvider({
+        url: 'https://wms.im-ldi.com/',
+        layers: 'mars_viking_mdim2.1',
+        parameters: {
+          service: 'WMS',
+          format: 'image/png',
+          transparent: false,
+          crs: 'EPSG:3857',
+          dpiMode: 7
+        },
+        tilingScheme: new Cesium.WebMercatorTilingScheme()
+      });
+
+      const marsViewModel = new Cesium.ProviderViewModel({
+        name: 'Mars (Viking MDIM 2.1)',
+        iconUrl: Cesium.buildModuleUrl('Assets/Textures/moonSmall.jpg'), // Using moon texture as placeholder
+        tooltip: 'Mars Viking Mission MDIM 2.1 Global Mosaic',
+        category: 'Celestial Bodies',
+        creationFunction: () => marsWmsProvider
+      });
+
       const mapboxLayer = new Cesium.UrlTemplateImageryProvider({
         url: `https://api.mapbox.com/styles/v1/mapbox/satellite-streets-v12/tiles/{z}/{x}/{y}?access_token=${mapboxToken}`,
         tilingScheme: new Cesium.WebMercatorTilingScheme(),
@@ -1106,6 +1211,10 @@ window.customElements.define(
         creationFunction: () => mapboxLayer,
       });
 
+      // Add Moon and Mars to imagery sources
+      imagerySources.push(moonViewModel);
+      imagerySources.push(marsViewModel);
+
       let mapSettings;
 
       if (mapboxToken) {
@@ -1122,6 +1231,13 @@ window.customElements.define(
         };
       }
 
+      // Store celestial body providers for programmatic switching
+      this.celestialBodyProviders = {
+        moon: moonWmsProvider,
+        mars: marsWmsProvider
+      };
+      this.currentBaseLayer = 'earth'; // Track current base layer
+
       if (Cesium.Ion.defaultAccessToken) {
         mapSettings.terrain = Cesium.Terrain.fromWorldTerrain();
       } else if (mapboxToken) {

app/js/utils.js

@@ -519,6 +519,7 @@ export const configureLayer = async (
             rootUrl: `/geofm-geoserver/geoserver/${fmType}/wms/` + item["uri"],
             layer: item["uri"],
             name: item["display_name"],
+            baseLayer: item["baseLayer"] || item["base_layer"] || "earth", // Support for celestial body base layers
             z_index: item["z_index"],
             wmsParams: {
               ...(isNotEmpty(item["sld_body"]) && {

docs/BASE_LAYER_CONFIGURATION.md

@@ -0,0 +1,238 @@
+# Base Layer Configuration for Celestial Bodies
+
+## Overview
+
+The Geospatial Studio UI now supports multiple celestial body base layers including Earth, Moon, and Mars. The system can automatically switch base layers based on dataset configuration.
+
+## Supported Celestial Bodies
+
+- **Earth** (default) - Various Earth imagery providers (Cesium Ion, Mapbox, OpenStreetMap, etc.)
+- **Moon** - Lunar Reconnaissance Orbiter Wide Angle Camera Global Mosaic
+- **Mars** - Mars Viking Mission MDIM 2.1 Global Mosaic
+- **Solar** - Reserved for future implementation
+
+## Base Layer Selector
+
+All celestial body base layers are always available in the Cesium base layer selector UI, regardless of which dataset is currently loaded. Users can manually switch between any base layer at any time.
+
+## Automatic Base Layer Switching
+
+When datasets include a `baseLayer` property, the system will automatically switch to the appropriate celestial body imagery.
+
+## Backend API Configuration
+
+### Dataset Response Structure
+
+When returning dataset information from the backend API, include the `baseLayer` property to specify which celestial body the dataset is associated with:
+
+```json
+{
+  "dataset_id": "lunar_surface_001",
+  "name": "Lunar Surface Analysis",
+  "description": "High-resolution lunar surface data",
+  "baseLayer": "moon",
+  "layers": [
+    {
+      "uri": "lunar_surface_layer",
+      "display_name": "Surface Analysis",
+      "z_index": 1,
+      "visible_by_default": "True",
+      "baseLayer": "moon"
+    }
+  ],
+  "created_at": "2026-03-11T00:00:00Z"
+}
+```
+
+### Layer Configuration Structure
+
+When constructing layer data in the UI (e.g., in `utils.js`), the `baseLayer` property should be preserved:
+
+```javascript
+let thisLayer = {
+  datasource: "geoserver",
+  rootUrl: "/geoserver/wms/" + item["uri"],
+  layer: item["uri"],
+  name: item["display_name"],
+  baseLayer: item["baseLayer"] || "earth",  // ← Include this property
+  z_index: item["z_index"],
+  wmsParams: {
+    sld_body: item["sld_body"]
+  },
+  params: {
+    crs: "EPSG:3857"
+  },
+  ui: {
+    visible: true,
+    opacity: item["visible_by_default"] === "True" ? 1 : 0
+  }
+};
+```
+
+## Example Configurations
+
+### Earth Dataset (Default)
+
+```json
+{
+  "dataset_id": "earth_weather_001",
+  "name": "Global Weather Data",
+  "baseLayer": "earth",
+  "layers": [
+    {
+      "uri": "weather_temperature",
+      "display_name": "Temperature",
+      "baseLayer": "earth"
+    }
+  ]
+}
+```
+
+**Note:** If `baseLayer` is omitted, the system defaults to Earth imagery.
+
+### Moon Dataset
+
+```json
+{
+  "dataset_id": "lunar_crater_001",
+  "name": "Lunar Crater Analysis",
+  "baseLayer": "moon",
+  "layers": [
+    {
+      "uri": "lunar_craters",
+      "display_name": "Crater Distribution",
+      "baseLayer": "moon"
+    }
+  ]
+}
+```
+
+### Mars Dataset
+
+```json
+{
+  "dataset_id": "mars_terrain_001",
+  "name": "Mars Terrain Elevation",
+  "baseLayer": "mars",
+  "layers": [
+    {
+      "uri": "mars_elevation",
+      "display_name": "Elevation Data",
+      "baseLayer": "mars"
+    }
+  ]
+}
+```
+
+## WMS Server Configuration
+
+### Moon WMS
+- **URL**: `https://wms.im-ldi.com/`
+- **Layer**: `luna_wac_global`
+- **CRS**: `EPSG:3857`
+- **Format**: `image/png`
+- **dpiMode**: `7`
+
+### Mars WMS
+- **URL**: `https://wms.im-ldi.com/`
+- **Layer**: `mars_viking_mdim2.1`
+- **CRS**: `EPSG:3857`
+- **Format**: `image/png`
+- **dpiMode**: `7`
+
+## User Experience
+
+### Automatic Switching
+1. User loads a dataset with `baseLayer: "moon"`
+2. System automatically switches the base layer to Moon imagery
+3. User's data layers are displayed on top of the Moon base layer
+
+### Manual Override
+1. User can manually select any base layer from the base layer picker at any time
+2. Manual selection takes precedence over automatic switching
+3. All celestial body options are always visible in the selector
+
+### Base Layer Persistence
+- The current base layer persists until:
+  - A new dataset with a different `baseLayer` is loaded
+  - User manually selects a different base layer
+  - Page is refreshed (resets to default)
+
+## Implementation Details
+
+### Frontend (app-map.js)
+
+The `switchBaseLayer(celestialBody)` method handles automatic switching:
+
+```javascript
+// Automatically called when loading layers with baseLayer property
+switchBaseLayer('moon');  // Switches to Moon imagery
+switchBaseLayer('mars');  // Switches to Mars imagery
+switchBaseLayer('earth'); // Returns to Earth imagery
+```
+
+### Layer Loading Integration
+
+The `addWMSLayer()` method checks for the `baseLayer` property:
+
+```javascript
+addWMSLayer(layerData) {
+  // Check if layer specifies a base layer and switch if needed
+  if (layerData.baseLayer) {
+    this.switchBaseLayer(layerData.baseLayer);
+  }
+
+  // Continue with normal layer loading...
+}
+```
+
+## Testing
+
+To test the base layer functionality:
+
+1. **Manual Selection Test**
+   - Open the inference page
+   - Click the base layer selector (globe icon in Cesium viewer)
+   - Verify Moon and Mars appear in the list under "Celestial Bodies"
+   - Select Moon - verify Moon imagery loads
+   - Select Mars - verify Mars imagery loads
+
+2. **Automatic Switching Test**
+   - Load a dataset with `baseLayer: "moon"`
+   - Verify the base layer automatically switches to Moon
+   - Load a dataset with `baseLayer: "mars"`
+   - Verify the base layer automatically switches to Mars
+   - Load a dataset without `baseLayer` or with `baseLayer: "earth"`
+   - Verify Earth imagery is used
+
+3. **User Override Test**
+   - Load a Moon dataset (auto-switches to Moon base layer)
+   - Manually select an Earth base layer from the picker
+   - Verify the manual selection persists
+   - Load another Moon dataset
+   - Verify it switches back to Moon
+
+## Troubleshooting
+
+### Base Layer Not Switching
+- Check that the `baseLayer` property is included in the layer data
+- Verify the value is one of: `"earth"`, `"moon"`, `"mars"` (case-insensitive)
+- Check browser console for switching messages
+
+### Moon/Mars Not Appearing in Selector
+- Verify the WMS servers are accessible
+- Check for JavaScript errors in browser console
+- Ensure Cesium library is loaded correctly
+
+### WMS Server Errors
+- Verify WMS server URLs are correct and accessible
+- Check network tab for failed requests
+- Ensure CORS is properly configured on WMS servers
+
+## Future Enhancements
+
+- Add Solar base layer when imagery becomes available
+- Support for additional celestial bodies (Venus, Jupiter moons, etc.)
+- User preference for default base layer
+- Base layer preview thumbnails
+- Caching of base layer providers for performance