Les éléments définis dans un langage informatique, tels que les classes ou méthodes en Java ainsi que les éléments dans un fichier XML, apparaissent avec une police de caractères mono-espacée. Afin de faciliter la compréhension des liens qui existent entre Apache SIS et les standards, ces éléments sont en outre représentés en utilisant les codes de couleurs suivants:

• Les éléments en bleu sont définis dans un standard de l’OGC ou de l’ISO. Exemple: CD_Ellipsoid.
• Les éléments en vert sont définis dans GeoAPI. Exemple: Ellipsoid.
• Les éléments en brun sont définis dans Apache SIS. Exemple: DefaultEllipsoid.
• Les éléments laissés en noir sont soient définis ailleurs (exemple: String), ou ne font pas l’objet d’une emphase particulière pour la discussion.

Des compléments d’information apparaissent dans des boîtes grises. Le lecteur peut ignorer ces boîtes grises sans que cela ne nuise à la compréhension du texte.

Choix des termes

Les standards privilégient parfois l’application de certains termes génériques à des contextes particuliers, qui peuvent différer du contexte dans lequel d’autres communautés emploient ces termes. Par exemple les termes domain et range peuvent s’appliquer à des fonctions arbitraires pour désigner l’ensemble des valeurs possibles en entrés et en sorties respectivement. Mais les fonctions auxquelles certains standards ISO les appliquent ne sont pas les mêmes que les fonctions auxquelles d’autres bibliothèques les appliquent. Par exemple ISO 19123 applique ces termes aux objets CV_Coverage, vus comme des fonctions dont le domaine est l’ensemble des coordonnées spatio-temporelles de la couverture de données et le range l’ensemble des valeurs de la couverture. Mais la bibliothèque netCDF de l’UCAR applique plutôt ces termes à la fonction convertissant les indices de pixels (son domaine) vers les coordonnées spatio-temporelles (son range). Ainsi, un range de la bibliothèque de l’UCAR peut être le domaine de ISO 19123.

La bibliothèque Apache SIS privilégie autant que possible l’utilisation des termes dans le sens des normes OGC et ISO. Mais un soin particulier doit être apporté aux interfaces entre SIS et certaines bibliothèques externes, afin de réduire les risques de confusions.