Merge branch 'main' into scene_coordinateTransformations_input_path_optional

Author: jo-mueller

authors.yml

@@ -36,7 +36,8 @@ project:
       github: toloudis
       orcid: 0000-0003-2620-1233
 
-    - name: Forest Collmann
+    - name: Forrest Collman
+      orcid: 0000-0002-0280-7022
       github: fcollman
 
     - name: Nathalie Gaudreault

examples/coordinate_systems/.config.json

@@ -1475,6 +1475,12 @@ is the coordinate system that is referenced by all multiscale coordinate transfo
   * A single scale or identity transformation
   * A sequence transformation containing one scale and one translation transformation.
 
+  ```{note}
+  These transformations are expected to consistently align the datasets across all scales in the intrinsic coordinate system.
+  For the most common downsampling methods such as classical binning,
+  translations should be (pixel-size-at-resolution-N - pixel-size-at-resolution-0) / 2 for correct multi-scale alignment.
+  ```
+
   In these cases, the scale transformation specifies the pixel size in physical units or time duration.
   If scaling information is not available or applicable for one of the axes,
   the value MUST express the scaling factor between the current resolution
@@ -1979,6 +1985,20 @@ A transformation from instrument3 to instrument1 can be obtained
 by composing the two transformations above.
 :::
 
+```{hint} Which coordinate system to display?
+When reading [`scene`](#scene-md) metadata,
+some applications may want to choose a coordinate system as a default reference,
+e.g. for immediate display.
+If they do so, it is RECOMMENDED that the scene's first entry under the `coordinateSystems` field is used as the default, if present.
+ Likewise, when writing scene metadata, if there is a coordinate system that acts as a common reference for other coordinate systems within the scene or its child multiscales, it is RECOMMENDED that this coordinate system be stored as the first coordinateSystems entry in the scene.
+
+If no coordinate system is defined therein, but only in the respective linked multiscale groups,
+viewers may want to expose a choice for the user to select a coordinate system for display when opening the dataset for the first time.
+
+ 
+
+```
+
 ## Specification naming style
 (naming-style)=
 

examples/coordinate_systems/arrayCoordSys.json

@@ -48,41 +48,12 @@
                         "additionalProperties": false,
                         "description": "Must reference a coordinate system defined in the same metadata document (path empty)"
                       }
-                    },
-                    "required": ["input", "output"]
-                  }
-                ]
-              } 
-            },
-            "arrayCoordinateSystem": {
-              "type": "object",
-              "properties": {
-                "name": {
-                  "type": "string",
-                  "description": "Name of coordinate space"
-                },
-                "axes": {
-                  "allOf": [
-                    {
-                      "$ref": "axes.schema"
-                    },
-                    {
-                      "type": "array",
-                      "items": {
-                        "type": "object",
-                        "properties": {
-                          "type": {
-                            "const": "array"
-                          }
-                        }
-                      }
-                    }
-                  ]
+                    ]
+                  },
+                  "description": "Constrained input/output for coordinate transformations in scene metadata"
                 }
-              },
-              "required": [
-                "axes"
               ]
+                
             }
           },
           "type": "object",

index.md

@@ -8,6 +8,12 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
+## [0.6.rc0] - 2026-06-11
+
+### Added
+
+- Added suggestion on which coordinate system to use for display in the spec document.
+
 ## [0.6.dev4] - 2026-04-22
 
 ### Changed