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;
+}
