Author: desruisseaux
Date: Tue Feb 19 16:51:04 2013
New Revision: 1447808
URL: http://svn.apache.org/r1447808
Log:
Added documentation about ranges in the developer guide.
Added:
sis/branches/JDK7/src/main/docbook/fr/coverage.xml (with props)
Modified:
sis/branches/JDK7/src/main/docbook/fr.xml
Modified: sis/branches/JDK7/src/main/docbook/fr.xml
URL:
http://svn.apache.org/viewvc/sis/branches/JDK7/src/main/docbook/fr.xml?rev=1447808&r1=1447807&r2=1447808&view=diff
==============================================================================
--- sis/branches/JDK7/src/main/docbook/fr.xml (original)
+++ sis/branches/JDK7/src/main/docbook/fr.xml Tue Feb 19 16:51:04 2013
@@ -33,5 +33,6 @@
<xi:include href="fr/XML.xml"/>
<xi:include href="fr/utility.xml"/>
<xi:include href="fr/geometry.xml"/>
+ <xi:include href="fr/coverage.xml"/>
</book>
Added: sis/branches/JDK7/src/main/docbook/fr/coverage.xml
URL:
http://svn.apache.org/viewvc/sis/branches/JDK7/src/main/docbook/fr/coverage.xml?rev=1447808&view=auto
==============================================================================
--- sis/branches/JDK7/src/main/docbook/fr/coverage.xml (added)
+++ sis/branches/JDK7/src/main/docbook/fr/coverage.xml Tue Feb 19 16:51:04 2013
@@ -0,0 +1,82 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE book [
+ <!ENTITY % book.entities SYSTEM "../book.entities">
+ %book.entities;
+]>
+<chapter xmlns="http://docbook.org/ns/docbook"; version="5.0"
+ xmlns:xlink = "http://www.w3.org/1999/xlink";>
+
+ <title>Couvertures de données
(<foreignphrase>Coverages</foreignphrase>)</title>
+ <para>
+ Les images, souvent nommées <foreignphrase>rasters</foreignphrase> en
anglais, sont des cas particuliers
+ dâune structure de données appelée
<foreignphrase>coverages</foreignphrase>.
+ On pourrait traduire ce terme anglais par « couverture de données ».
+ Le titre du standard les décrivant, â<foreignphrase>Coverage geometry
and functions</foreignphrase>â
+ (<acronym>ISO</acronym> 19123), résume bien les deux éléments
essentiels des couvertures de données:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Un <foreignphrase>coverage</foreignphrase> est une fonction qui, Ã
partir dâune coordonnée spécifiée en entrée,
+ retourne une valeur dâattribut. Lâensemble des valeurs pouvant
être données en entrée est appelé le domaine
+ (<foreignphrase>domain</foreignphrase> en anglais), alors que
lâensemble des valeurs pouvant être retournées
+ est appelé <foreignphrase>range</foreignphrase> en anglais.
+ </para>
+ <informalexample><para>
+ <emphasis role="bold">Exemple:</emphasis> les valeurs des pixels
dâune image pourraient contenir des mesures
+ dâélévation du terrain. Si une fonction <mathphrase>h =Â
f(λ,Ï)</mathphrase> permet dâobtenir (éventuellement
+ à lâaide dâinterpolations) lâélévation
<mathphrase>h</mathphrase> en fonction dâune coordonnée géographique
+ <mathphrase>(λ,Ï)</mathphrase>, alors lâenveloppe géographique de
lâimage définie le <foreignphrase>domain</foreignphrase>,
+ la fonction <mathphrase>f</mathphrase> est le
<foreignphrase>coverage</foreignphrase>, et lâensemble des valeurs de
+ <mathphrase>h</mathphrase> que peut retourner cette fonction est le
<foreignphrase>range</foreignphrase>.
+ </para></informalexample>
+ </listitem>
+ <listitem>
+ <para>
+ Les différents types de couvertures peuvent se caractériser par
leurs géométries.
+ En particulier, une couverture nâest pas nécessairement composée
de cellules quadrilatérales.
+ Toutefois les cellules quadrilatérales étant de loin les plus
fréquentes, on utilisera souvent
+ le terme <foreignphrase>grid coverage</foreignphrase> pour désigner
les couvertures composées de telles cellules.
+ Dans <acronym>SIS</acronym>, la géométrie de ces couvertures est
décrite par la classe <classname role="SIS">GridGeometry</classname>.
+ </para>
+ </listitem>
+ </itemizedlist>
+
+ <para>
+ Le domaine est souvent lâespace spatio-temporel couvert par les
données, mais rien dans <acronym>SIS</acronym>
+ nâempêche les couvertures de sâétendre sur dâautres dimensions.
Par exemple les études en thermodynamique
+ utilisent souvent un espace dont les dimensions sont la température et la
pression.
+ </para>
+
+ <sidebar>
+ <title>Le <classname role="SIS">Range</classname> de
<acronym>SIS</acronym> et sa relation avec les standards</title>
+ <para>
+ Les caractéristiques du domaine spatial sont définies par le standard
<acronym>ISO</acronym> 19123,
+ alors que les caractéristiques du <foreignphrase>range</foreignphrase>
ne font pas parties du standard.
+ Le standard mentionne simplement que les
<foreignphrase>ranges</foreignphrase> peuvent être finis ou infinis,
+ et ne sont pas nécessairement numériques.
+ Par exemple les valeurs retournées par une couverture peuvent provenir
dâune énumération
+ (« ceci est une forêt », « ceci est un lac »,
<foreignphrase>etc.</foreignphrase>).
+ </para>
+ <para>
+ Les interpolations nâétant possibles quâavec les valeurs
numériques, les <foreignphrase>ranges</foreignphrase> de valeurs
+ non-numériques ne peuvent être utilisés quâavec les couvertures de
type <classname role="OGC">CV_DiscreteCoverage</classname>.
+ En revanche, les <foreignphrase>ranges</foreignphrase> de valeurs
numériques peuvent aussi
+ être utilisés avec des couvertures de type <classname
role="OGC">CV_ContinuousCoverage</classname>.
+ Ces deux types de <foreignphrase>ranges</foreignphrase> sont
représentés dans <acronym>SIS</acronym>
+ par les classes <classname role="SIS">Range</classname> et <classname
role="SIS">NumberRange</classname> respectivement.
+ La classe <classname role="SIS">NumberRange</classname> est la plus
utilisée et celle qui se rapproche le plus de la
+ <link
xlink:href="http://fr.wikipedia.org/wiki/Intervalle_%28math%C3%A9matiques%29";>notion
mathématique usuelle dâun intervalle</link>.
+ Se représentation textuelle se rapproche des spécifications du
standard <acronym>ISO</acronym> 31-11, excepté que le caractère ââ¦â
+ est utilisé à la place de la virgule comme séparateur des valeurs.
+ Par exemple â[0 ⦠256)â représente la plage des valeurs 0
inclusivement à 256 exclusivement.
+ </para>
+ <para>
+ Les objets <classname role="SIS">Range</classname> ne sont associés aux
couvertures que indirectement.
+ Dans <acronym>SIS</acronym>, les valeurs que peuvent retourner les
couvertures sont décrites par des
+ objets de type <classname role="SIS">SampleDimension</classname>. Ce
sont ces derniers qui contiendront
+ des instances de <classname role="SIS">Range</classname> ainsi que
dâautres informations telles quâune
+ fonction de transfert (décrite plus loin).
+ </para>
+ </sidebar>
+</chapter>
Propchange: sis/branches/JDK7/src/main/docbook/fr/coverage.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: sis/branches/JDK7/src/main/docbook/fr/coverage.xml
------------------------------------------------------------------------------
svn:mime-type = text/xml
