sis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From desruisse...@apache.org
Subject svn commit: r1815146 - in /sis/site/trunk/content/openoffice: fr/formula.html openoffice.css
Date Mon, 13 Nov 2017 22:42:47 GMT
Author: desruisseaux
Date: Mon Nov 13 22:42:46 2017
New Revision: 1815146

URL: http://svn.apache.org/viewvc?rev=1815146&view=rev
Log:
Describe formulas.

Modified:
    sis/site/trunk/content/openoffice/fr/formula.html
    sis/site/trunk/content/openoffice/openoffice.css

Modified: sis/site/trunk/content/openoffice/fr/formula.html
URL: http://svn.apache.org/viewvc/sis/site/trunk/content/openoffice/fr/formula.html?rev=1815146&r1=1815145&r2=1815146&view=diff
==============================================================================
--- sis/site/trunk/content/openoffice/fr/formula.html [UTF-8] (original)
+++ sis/site/trunk/content/openoffice/fr/formula.html [UTF-8] Mon Nov 13 22:42:46 2017
@@ -29,10 +29,11 @@
   <body>
     <h1>Formules ajoutées dans Calc</h1>
     <p>
-      L’extension Apache SIS pour Open/LibreOffice fournit de nouvelles fonctions réparties
dans 2 catégories: <i>Texte</i> et <i>Add-in</i>.
-      Le principe de base des fonctions de la catégorie <i>Add-in</i> est le
suivant:
-      chaque système de référence des coordonnées est identifié par un code numérique
de la base de données EPSG.
-      Cette base de données recense plus de 6000 systèmes en usage sur la planète,
+      L’extension Apache SIS pour Open/LibreOffice fournit de nouvelles fonctions réparties
dans 2 catégories : <i>Texte</i> et <i>Add-in</i>.
+      Le principe de base des fonctions de la catégorie <i>Add-in</i> est le
suivant :
+      chaque système de référence des coordonnées est identifié par un code numérique
de la
+      <a href="http://www.epsg.org/">base de données géodesiques EPSG</a> ou
d’une autre autorité.
+      La base de donnnées EPSG recense plus de 6000 systèmes en usage sur la planète,
       ainsi que des paramètres permettant d’effectuer des transformations d’un système
vers un autre.
       Certaines fonctions permettent d’obtenir des informations sur un système de référence
en particulier,
       par exemple son domaine de validité. Ces fonctions n’attendent qu’un seul code
EPSG en paramètre.
@@ -47,7 +48,17 @@
       dont <a href="http://www.epsg.org/TermsOfUse">l’utilisation est soumise à
des conditions</a>.
       Apache SIS étend cette liste avec quelques codes définis en dehors d’EPSG, notamment
par l’OGC.
       Un sommaire des codes embarqués par Apache SIS est <a href="../../tables/CoordinateReferenceSystems.html">donné
ici</a>.
-    </p><p>
+      La syntaxe des codes acceptés
+      <a href="../../apidocs/org/apache/sis/referencing/CRS.html#forCode-java.lang.String-">est
décrite dans la Javadoc de Apache SIS</a>.
+      Par exemple, tous les codes suivants sont considérés équivalents à <code>"EPSG:4326"</code> :
+    </p>
+    <ul>
+      <li><code>"EPSG::4326"</code></li>
+      <li><code>"urn:ogc:def:crs:EPSG::4326"</code></li>
+      <li><code>"http://www.opengis.net/def/crs/epsg/0/4326"</code></li>
+      <li><code>"http://www.opengis.net/gml/srs/epsg.xml#4326"</code></li>
+    </ul>
+    <p>
       La plupart des fonctions opérant sur des coordonnées sont des fonctions matricielles.
       Leurs sorties nécessitent plusieurs colonnes, autant qu’il y a de dimensions dans
le système de référence utilisé.
       Par exemple si une fonction doit retourner une coordonnée à trois dimensions,
@@ -62,5 +73,203 @@
       Cela permet à Apache SIS de récupérer les informations associées aux codes EPSG
une seule fois pour toutes les lignes de la matrice,
       plutôt que de recommencer cette opération pour chaque fonction recopiée.
     </p>
+
+    <section>
+      <h2 id="TEXT.ANGLE">TEXTE.ANGLE</h2>
+      <p>
+        Convertit une valeur numérique en chaîne de caractères représentant un angle.
+        La valeur numérique doit être un angle en degrés décimaux (par exemple 12,5 pour
12°30′).
+        La chaîne retournée peut être un angle sexagésimal, en fonction du modèle donné
en argument.
+        Ce modèle comprend quelques caractères spéciaux
+        <a href="../../apidocs/org/apache/sis/measure/AngleFormat.html">décrits dans
la Javadoc de Apache SIS</a>,
+        dont les principaux sont : <var>D</var>, <var>M</var>, <var>S</var>,
<var>d</var>, <var>m</var> et <var>s</var>.
+        Le caractère <var>D</var> représente la partie entière des degrés,
et <var>d</var> la partie fractionnaire.
+        Le symbole <var>M</var> représente la partie entière des minutes, et
<var>m</var> la partie fractionnaire.
+        Enfin le symbole <var>S</var> représente la partie entière des secondes,
et <var>s</var> la partie fractionnaire.
+      </p>
+      <table>
+        <caption>Exemples</caption>
+        <tr><th>Formule</th> <th>Résultat</th></tr>
+        <tr><td><code>=TEXTE.ANGLE(167,1590; "DD°")</code></td>
        <td>167°</td></tr>
+        <tr><td><code>=TEXTE.ANGLE(167,1590; "DD°MM′")</code></td>
     <td>167°10′</td></tr>
+        <tr><td><code>=TEXTE.ANGLE(167,1590; "DD°MM′SS″")</code></td>
  <td>167°09′32″</td></tr>
+        <tr><td><code>=TEXTE.ANGLE(167,1590; "DD°MM′SS.s″")</code></td>
<td>167°09′32,4″</td></tr>
+      </table>
+    </section>
+
+
+    <section>
+      <h2 id="VALUE.ANGLE">VALEUR.ANGLE</h2>
+      <p>
+        Convertit en valeur numérique une chaîne de caractères représentant un angle.
+        Cette fonction est l’inverse de <code><a href="#TEXT.ANGLE">TEXTE.ANGLE</a></code>.
+        La chaîne de caractères peut représenter un angle sexagésimal, à la condition
que les symboles °, ′ et ″
+        soient correctement utilisés pour identifier les degrés, minutes et secondes respectivement.
+        L’hémisphère (<cite>N</cite>, <cite>S</cite>, <cite>E</cite>
ou <cite>W</cite>) est optionnel.
+        L’angle retourné est toujours exprimé en degrés décimaux.
+      </p><p>
+        Les symboles °, ′ et ″ n’ont pas besoin d’être tous présents.
+        Ils peuvent être complètement omis si un modèle approprié est donné en argument.
+        Par exemple si le modèle est <cite>DDMM</cite>, alors cette fonction
traduira le texte 0430 en la valeur 4,5°.
+        Excepté pour de tels cas où les symboles différentiateurs de champs sont complètement
absents,
+        le modèle donné à la fonction <code>VALEUR.ANGLE</code> est plutôt
à titre indicatif.
+        Cette fonction est assez tolérante et devrait interpréter correctement des chaînes
de caractères
+        qui ne correspondent pas exactement au modèle.
+      </p>
+    </section>
+
+
+    <section>
+      <h2 id="CRS.NAME">NOM.SRS</h2>
+      <p>
+        Retourne le nom du système de référence identifié par le code donné.
+        Le code du système est l’unique argument attendu par cette fonction.
+        Bien que cette fonction soit conçue pour retourner le nom de systèmes de références
spatiaux (SRS),
+        elle peut aussi retourner le nom de d’autres types d’objets à la condition que
leur type soit explicité
+        (par exemple : <code>"urn:ogc:def:<b>datum</b>:EPSG::6326"</code>).
+      </p>
+      <table>
+        <caption>Exemples</caption>
+        <tr><th>Formule</th> <th>Résultat</th></tr>
+        <tr><td><code>=NOM.SRS("EPSG:3060")</code></td> <td>IGN72
Grande Terre / UTM zone 58S</td></tr>
+        <tr><td><code>=NOM.SRS("EPSG:3061")</code></td> <td>Porto
Santo 1995 / UTM zone 28N</td></tr>
+        <tr><td><code>=NOM.SRS("EPSG:4326")</code></td> <td>WGS
84</td></tr>
+        <tr><td><code>=NOM.SRS("EPSG:4329")</code></td> <td>WGS
84 (3D)</td></tr>
+      </table>
+    </section>
+
+
+    <section>
+      <h2><a id="CRS.USAGE">USAGE.SRS</a></h2>
+      <p>
+        Retourne le domaine d’utilisation du système de référence identifié par le
code donné.
+        L’objet est habituellement, mais pas obligatoirement, un Système de Références
Spatiales (SRS).
+        Le code du système est l’unique argument attendu par cette fonction.
+        Bien que cette fonction soit conçue pour retourner le domaine d’utilisation de
systèmes de références spatiaux (SRS),
+        elle peut aussi retourner le domaine de d’autres types d’objets à la condition
que leur type soit explicité
+        (par exemple : <code>"urn:ogc:def:<b>datum</b>:EPSG::6326"</code>).
+      </p>
+      <table>
+        <caption>Exemples</caption>
+        <tr><th>Formule</th> <th>Résultat</th></tr>
+        <tr><td><code>=USAGE.SRS("EPSG:3060")</code></td> <td>Large
and medium scale topographic mapping and engineering survey.</td></tr>
+        <tr><td><code>=USAGE.SRS("EPSG:4327")</code></td> <td>Used
by GPS satellite navigation system.</td></tr>
+      </table>
+    </section>
+
+
+    <section>
+      <h2 id="REGION.NAME">NOM.REGION</h2>
+      <p>
+        Retourne une description textuelle de la région dans laquelle un objet est valide.
+        Cette description comprend habituellement les noms des pays ou provinces pour lesquels
le système a été conçu.
+        L’objet donné en argument est souvent, mais pas obligatoirement, un code de Système
de Références Spatiales (SRS).
+      </p>
+      <table>
+        <caption>Exemples</caption>
+        <tr><th>Formule</th> <th>Résultat</th></tr>
+        <tr><td><code>=NOM.REGION("EPSG:3060")</code></td>
<td>New Caledonia - Grande Terre.</td></tr>
+        <tr><td><code>=NOM.REGION("EPSG:4326")</code></td>
<td>World.</td></tr>
+      </table>
+    </section>
+
+
+    <section>
+      <h2 id="GEOGRAPHIC.AREA">REGION.GEOGRAPHIQUE</h2>
+      <p>
+        Retourne sous forme de boîte englobante le domaine d’un objet identifié par le
code donné.
+        La boîte est exprimée par une matrice 2×2 avec les latitudes dans la première
colonne et les longitudes dans la seconde colonne.
+        Si le code donné identifie un système de référence spatial, alors cette fonction
retourne les coordonnées géographiques
+        de la région dans laquelle le système est valide. La sortie contient les coordonnées
géographiques
+        (toujours en degrés décimaux de <var>latitude</var>, <var>longitude</var>)
du coin supérieur gauche sur la
+        première ligne, et du coin inférieur droit sur la seconde ligne.
+        En d’autres termes, les valeurs retournées par cette fonction se répartissent
comme suit :
+      </p>
+      <table class="grid">
+        <tr><td>Nord</td> <td>Ouest</td></tr>
+        <tr><td>Sud</td>  <td>Est</td></tr>
+      </table>
+    </section>
+
+
+    <section>
+      <h2 id="CRS.AXIS">AXE.SRS</h2>
+      <p>
+        Retourne le nom d’un axe d’un système de référence de coordonnées avec ses
unités.
+        Cette fonction attend en arguments le code d’un système de référence, suivit
de l’index d’un de ses axes.
+        Les index sont numérotés de 1 jusqu’au nombre de dimensions du système de référence,
inclusivement.
+        Cette fonction est particulièrement utile pour obtenir le libellé des colonnes
qui contiendront les coordonnées.
+      </p>
+      <table>
+        <caption>Exemples</caption>
+        <tr><th>Formule</th> <th>Résultat</th></tr>
+        <tr><td><code>=AXE.SRS("EPSG:4326";  1)</code></td>
<td>Latitude (°)</td></tr>
+        <tr><td><code>=AXE.SRS("EPSG:4326";  2)</code></td>
<td>Longitude (°)</td></tr>
+        <tr><td><code>=AXE.SRS("EPSG:32758"; 1)</code></td>
<td>Easting (m)</td></tr>
+        <tr><td><code>=AXE.SRS("EPSG:32758"; 2)</code></td>
<td>Northing (m)</td></tr>
+      </table>
+    </section>
+
+
+    <section>
+      <h2 id="TRANSFORM.POINTS">TRANSFORM.POINTS</h2>
+      <p>
+        Applique un changement (transformation ou conversion) de coordonnées sur des points.
+        Les coordonnées à transformer doivent être disposées sous forme de tableau avec
une coordonnée par ligne
+        et autant de colonnes qu’il y a de dimensions dans leur système de référence
(habituellement deux ou trois).
+        La sortie aura une disposition similaire. Cette fonction attend trois arguments :
+      </p>
+      <ul>
+        <li>Le code du système de référence source.</li>
+        <li>Le code du système de référence destination.</li>
+        <li>La plage de coordonnées à transformer.</li>
+      </ul>
+      <p>
+        L’ordre et le nombre de colonnes dans la plage de coordonnées à transformer dépendent
du système de référence source.
+        L’ordre et le nombre de colonnes des coordonnées transformer (la sortie de cette
méthode) dépendent du système de référence destination.
+        Pour s’y retrouver, il est pratique d’utiliser la fonction <code><a
href="#CRS.AXIS">AXE.SRS</a></code> pour le libellé des colonnes.
+      </p><p>
+        Toutes les transformations de coordonnées n’ont pas la même précision.
+        Pour obtenir une estimation de l’erreur, on peut utiliser la fonction <code><a
href="#TRANSFORM.ACCURACY">PRECISION.TRANSFORM</a></code>
+        avec les mêmes arguments que ceux qui auront été spécifiés à <code>TRANSFORM.POINTS</code>.
+      </p>
+    </section>
+
+
+    <section>
+      <h2 id="TRANSFORM.ENVELOPE">TRANSFORM.ENVELOPPE</h2>
+      <p>
+        Applique un changement (transformation ou conversion) une boîte englobante.
+        Cette fonction prend les mêmes arguments que <code><a href="#TRANSFORM.POINTS">TRANSFORM.POINTS</a></code>,
+        mais ne retournera que deux lignes. La première ligne contiendra les coordonnées
transformées minimales alors
+        que la second ligne contiendra les coordonnées transformées maximales.
+        Ce résultat peut être différent de celui que l’on obtiendrait en transformant
d’abord les points
+        puis en prenant leurs minimums et maximums. La raison de cette différence est que
cette fonction
+        <code>TRANSFORM.ENVELOPPE</code> prend en compte la courbure de la boîte
englobante sous l’effet
+        d’une projection cartographique ou autre transformation.
+      </p>
+    </section>
+
+    <section>
+      <h2><a id="TRANSFORM.ACCURACY">PRECISION.TRANSFORM</a></h2>
+      <p>
+        Retourne une <strong>estimation</strong> de la précision des transformations
de coordonnées entre deux systèmes de référence.
+        Cette fonction attend en argument les codes de deux systèmes de référence, habituellement
ceux qui seront spécifiés à la fonction
+        <code><a href="#TRANSFORM.POINTS">TRANSFORM.POINTS</a></code>.
+        Elle retourne une estimation de l’erreur induite par la transformation de coordonnées,
toujours en mètres.
+        Il ne s’agit pas de l’erreur due aux éventuelles imprécisions des algorithmes
de Apache SIS,
+        mais plutôt de l’erreur due à la nature stochastique des paramètres dès qu’un
changement de référentiel est impliqué
+        (ces paramètres sont déterminés empiriquement à partir d’un ensemble de points
exprimés selon les deux systèmes de références).
+      </p><p>
+        Des incertitudes sur les coordonnées calculées surviennent dès qu’il y a eu
changement de référentiel,
+        auquel cas on parle de <cite>transformation de coordonnées</cite> selon
la terminologie de la norme ISO 19111.
+        Lorsque le calcul consiste par exemple à appliquer une projection cartographique
sans changer de référentiel,
+        on parle alors de <cite>conversion de coordonnées</cite> (toujours selon
la terminologie de la norme ISO).
+        Dans ce dernier cas, la fonction <code>TRANSFORM.ACCURACY</code> peut
retourner 0,
+        ce qui signifie en fait que les changements de coordonnées se feront aux erreurs
d’arrondissements près
+        et selon les limites de la précision des algorithmes de Apache SIS.
+        L’erreur ne sera donc <em>pas réellement</em> nulle, mais devrait
être faible.
+      </p>
+    </section>
   </body>
 </html>

Modified: sis/site/trunk/content/openoffice/openoffice.css
URL: http://svn.apache.org/viewvc/sis/site/trunk/content/openoffice/openoffice.css?rev=1815146&r1=1815145&r2=1815146&view=diff
==============================================================================
--- sis/site/trunk/content/openoffice/openoffice.css [UTF-8] (original)
+++ sis/site/trunk/content/openoffice/openoffice.css [UTF-8] Mon Nov 13 22:42:46 2017
@@ -19,11 +19,11 @@ h2 {
   margin-left:  21px;
   margin-top:   30px;
   margin-bottom: 9px;
+  font-size: large;
 }
 
 section > p {
   margin-top: 9px;
-  text-align: justify;
 }
 
 section > p, section > ul {
@@ -35,3 +35,44 @@ section > blockquote {
   margin-left:  90px;
   margin-right: 60px;
 }
+
+p {
+  text-align: justify;
+}
+
+caption {
+  font-family:    sans-serif;
+  font-weight:    bold;
+  margin-top:     9px;
+  margin-bottom:  3px;
+  text-align:     left;
+}
+
+table {
+  margin-left:    60px;
+  margin-right:   auto;
+  border-style:   solid;
+  border-width:   1px;
+  border-spacing: 0px;
+}
+
+table tr th {
+  background-color:    #c9d5e8;
+  border-bottom-style: solid;
+  border-bottom-width: 1px;
+  padding-top:         4px;
+  padding-bottom:      1px;
+  padding-left:        12px;
+  text-align:          left;
+}
+
+table tr td {
+  padding-left:  12px;
+  padding-right: 12px;
+  background-color: whitesmoke;
+}
+
+table.grid td {
+  border-style: solid;
+  border-width: 0.5px;
+}



Mime
View raw message