PostGIS - en to fr translation catalogue (866 entries)

note: Tag: title
en: Raster Reference
fr: Référence Raster

note: Tag: para
en: The functions given below are the ones which a user of PostGIS Raster is likely to need and which are currently available in PostGIS Raster. There are other functions which are required support functions to the raster objects which are not of use to a general user.
fr: Les fonctions mentionnées ci-dessous sont celles qu'un utilisateur typique de PostGIS Raster sera amené à utiliser et qui sont disponibles dans PostGIS Raster. D'autres fonctions sont également définies, requises en interne pour le support des objets rasters, mais ne sont pas destinées à être utilisées par le grand public.

note: Tag: para
en: <varname>raster</varname> is a new PostGIS type for storing and analyzing raster data.
fr: <varname>raster</varname> est un nouveau type PostGIS pour stocker et analyser les données raster.

note: Tag: para
en: For loading rasters from raster files please refer to <xref linkend="RT_Loading_Rasters"/>
fr: Pour charger des rasters depuis des fichiers, voir <xref linkend="RT_Loading_Rasters"/>

note: Tag: para
en: For the examples in this reference we will be using a raster table of dummy rasters - Formed with the following code
fr: Pour les exemples dans cette section, nous utiliserons une table de rasters fictifs, créée via la requête suivante

note: Tag: para
en: This section lists the PostgreSQL data types specifically created to support raster functionality.
fr: Cette section liste les types de données PostgreSQL créés pour supporter les fonctionnalités raster.

note: Tag: title
en: Raster Support Data types
fr: Types de données pour la prise en charge raster

note: Tag: refpurpose
en: A spatial datatype with two fields - geom (holding a geometry object) and val (holding a double precision pixel value from a raster band).
fr: Un type spatial comportant deux champs : geom (stockant un objet géométrique) et val (stockant la valeur du pixel en double précision depuis une bande du raster).

note: Tag: para
en: geomval is a compound data type consisting of a geometry object referenced by the .geom field and val, a double precision value that represents the pixel value at a particular geometric location in a raster band. It is used by the ST_DumpAsPolygon and Raster intersection family of functions as an output type to explode a raster band into geometry polygons.
fr: geomval est un type composite, comprenant un objet géométrique dans le champ .geom et val, une valeur en double précision qui représente la valeur du pixel à un emplacement spécifique d'une bande raster. Ce type est utilisé par la fonction ST_DumpAsPolygon et la famille de fonctions d'intersection Raster, en tant que type de sortie pour éclater une bande raster en polygones.

note: Tag: title
en: See Also
fr: Voir aussi

note: Tag: refpurpose
en: <refpurpose>A composite type used as input into the ST_AddBand function defining the attributes and initial value of the new band.</refpurpose>
fr: <refpurpose>Un type composite utilisé comme entrée pour la fonction ST_AddBand pour définir les attributs et la valeur initiale d'une nouvelle bande.</refpurpose>

note: Tag: para
en: <para>A composite type used as input into the ST_AddBand function defining the attributes and initial value of the new band.</para>
fr: <para>Un type composite utilisé comme entrée pour la fonction ST_AddBand pour définir les attributs et la valeur initiale d'une nouvelle bande.</para>

note: Tag: para
en: 1-based value indicating the position where the new band will be added amongst the raster's bands. If NULL, the new band will be added at the end of the raster's bands.
fr: Indice (basé sur 1) où insérer la nouvelle bande dans la liste des bandes du raster. Si NULL, la nouvelle bande sera ajoutée en dernière position.

note: Tag: para
en: Pixel type of the new band. One of defined pixel types as described in <xref linkend="RT_ST_BandPixelType"/>.
fr: Type de pixel pour la nouvelle bande. Doit être un des types de pixels définis, tels que décrits dans <xref linkend="RT_ST_BandPixelType"/>.

note: Tag: para
en: Initial value that all pixels of new band will be set to.
fr: Valeur initiale pour tous les pixels de la nouvelle bande.

note: Tag: para
en: NODATA value of the new band. If NULL, the new band will not have a NODATA value assigned.
fr: Valeur NODATA pour la nouvelle bande. Si NULL, la nouvelle bande n'aura pas de valeur NODATA attribuée.

note: Tag: refpurpose
en: <refpurpose>A composite type for use when needing to express a raster and a band index of that raster.</refpurpose>
fr: <refpurpose>Un type composite pour représenter à la fois un raster et un indice d'une bande de ce raster.</refpurpose>

note: Tag: para
en: <para>A composite type for use when needing to express a raster and a band index of that raster.</para>
fr: <para>Un type composite pour représenter à la fois un raster et un indice d'une bande de ce raster.</para>

note: Tag: para
en: The raster in question/
fr: Le raster en question

note: Tag: para
en: 1-based value indicating the band of raster
fr: Indice (basé sur 1) de la bande du raster

note: Tag: refpurpose
en: raster spatial data type.
fr: Type de données raster spatial.

note: Tag: para
en: raster is a spatial data type used to represent raster data such as those imported from JPEGs, TIFFs, PNGs, digital elevation models. Each raster has 1 or more bands each having a set of pixel values. Rasters can be georeferenced.
fr: raster est le type de données spatial pour représenter les données rasters, telles qu'importées depuis des fichiers JPEGs, TIFFs, PNGs, modèles d'élévation numérique. Chaque raster a une ou plusieurs bandes, chacune correspondant à un ensemble de valeurs de pixels. Les rasters peuvent être géo-référencés.

note: Tag: para
en: Requires PostGIS be compiled with GDAL support. Currently rasters can be implicitly converted to geometry type, but the conversion returns the <xref linkend="RT_ST_ConvexHull"/> of the raster. This auto casting may be removed in the near future so don't rely on it.
fr: PostGIS doit être compilé avec le support GDAL. Actuellement, les rasters peuvent être implicitement convertis en type geometry, mais la conversion retourne un <xref linkend="RT_ST_ConvexHull"/> du raster. Ce transtypage implicite peut être supprimé dans le futur proche et ne devrait pas être utilisé.

note: Tag: title
en: Casting Behavior
fr: Transtypages

note: Tag: para
en: This section lists the automatic as well as explicit casts allowed for this data type
fr: Cette section liste les transtypages autorisés pour ce type de donnée, qu'ils soient automatiques ou bien explicites

note: Tag: entry
en: Cast To
fr: Transtypage vers

note: Tag: entry
en: Behavior
fr: Comportement

note: Tag: entry
en: automatic
fr: automatique

note: Tag: refpurpose
en: <refpurpose>A composite type used as input into the ST_Reclass function defining the behavior of reclassification.</refpurpose>
fr: <refpurpose>Un type composite utilisé comme entrée pour la fonction ST_Reclass pour définir le comportement de la reclassification.</refpurpose>

note: Tag: para
en: <para>A composite type used as input into the ST_Reclass function defining the behavior of reclassification.</para>
fr: <para>Un type composite utilisé comme entrée pour la fonction ST_Reclass pour définir le comportement de la reclassification.</para>

note: Tag: para
en: The band number of band to reclassify.
fr: L'indice de bande à reclassifier.

note: Tag: para
en: range expression consisting of comma delimited range:map_range mappings. : to define mapping that defines how to map old band values to new band values. ( means &gt;, ) means less than, ] &lt; or equal, [ means &gt; or equal
fr: Expression des classes, sous forme de correspondance range:map_range séparés par des virgules pour définir les correspondances entre les anciennes valeurs de la bande et la nouvelle valeur. ( signifie plus grand que, ) signifie plus petit que, ] signifie inférieur ou égal, [ signifie supérieur ou égal

note: Tag: para
en: ( notation is optional so a-b means the same as (a-b)
fr: La notation ( est facultative : a-b est équivalent à (a-b)

note: Tag: para
en: One of defined pixel types as described in <xref linkend="RT_ST_BandPixelType"/>
fr: Un des types de pixels définis, tels que décrits dans <xref linkend="RT_ST_BandPixelType"/>

note: Tag: para
en: Value to treat as no data. For image outputs that support transparency, these will be blank.
fr: Valeur à utiliser comme NODATA. Pour les formats d'images supportant la transparence, ces pixels seront transparents.

note: Tag: title
en: Example: Reclassify band 2 as an 8BUI where 255 is nodata value
fr: Exemple : Reclassifier la bande 2 en 8BUI avec 255 comme valeur NODATA

note: Tag: title
en: Example: Reclassify band 1 as an 1BB and no nodata value defined
fr: Exemple : Reclassifier la bande 1 en 1BB sans valeur NODATA

note: Tag: refpurpose
en: A composite type returned by the ST_SummaryStats and ST_SummaryStatsAgg functions.
fr: Un type composite retournée par les fonctions ST_SummaryStats et ST_SummaryStatsAgg.

note: Tag: para
en: A composite type returned by the <xref linkend="RT_ST_SummaryStats"/> and <xref linkend="RT_ST_SummaryStatsAgg"/> functions.
fr: Un type composite retournée par les fonctions <xref linkend="RT_ST_SummaryStats"/> et <xref linkend="RT_ST_SummaryStatsAgg"/>.

note: Tag: para
en: Number of pixels counted for the summary statistics.
fr: Nombre de pixels comptabilisés pour les résumés statistiques.

note: Tag: para
en: Sum of all counted pixel values.
fr: Somme des valeurs de tous les pixels comptabilisés.

note: Tag: para
en: Arithmetic mean of all counted pixel values.
fr: Moyenne arithmétique des valeurs de tous les pixels comptabilisés.

note: Tag: para
en: Standard deviation of all counted pixel values.
fr: Écart type des valeurs de tous les pixels comptabilisés.

note: Tag: para
en: Minimum value of counted pixel values.
fr: Minimum des valeurs de tous les pixels comptabilisés.

note: Tag: para
en: Maximum value of counted pixel values.
fr: Maximum des valeurs de tous les pixels comptabilisés.

note: Tag: refpurpose
en: <refpurpose>A composite type used as input into the ST_Union function defining the bands to be processed and behavior of the UNION operation.</refpurpose>
fr: <refpurpose>Un type composite utilisé comme entrée de la fonction ST_Union pour définir les bandes à traiter et le comportement de l'opération d'union.</refpurpose>

note: Tag: para
en: <para>A composite type used as input into the ST_Union function defining the bands to be processed and behavior of the UNION operation.</para>
fr: <para>Un type composite utilisé comme entrée de la fonction ST_Union pour définir les bandes à traiter et le comportement de l'opération d'union.</para>

note: Tag: para
en: 1-based value indicating the band of each input raster to be processed.
fr: Indice (basé sur 1) indiquant la bande de chaque raster d'entrée à traiter.

note: Tag: para
en: Type of UNION operation. One of defined types as described in <xref linkend="RT_ST_Union"/>.
fr: Type de l'opération d'union. Doit être un des types définis, tels que décrits dans <xref linkend="RT_ST_Union"/>.

note: Tag: title
en: Raster Management
fr: Gestion raster

note: Tag: refpurpose
en: Adds raster constraints to a loaded raster table for a specific column that constrains spatial ref, scaling, blocksize, alignment, bands, band type and a flag to denote if raster column is regularly blocked. The table must be loaded with data for the constraints to be inferred. Returns true if the constraint setting was accomplished and issues a notice otherwise.
fr: Ajoute des contraintes raster à une table pour une colonne spécifique pour contraindre le système de référence spatial, l'échelle, la taille des blocs, l'alignement, le nombre de bandes, le type de pixels, la contrainte d'unicité spatiale. La table doit être chargée avec des données pour que les contraintes puissent être inférées. Retourne true si les contraintes ont été ajoutées, ou émet une notice sinon.

note: Tag: para
en: Generates constraints on a raster column that are used to display information in the <varname>raster_columns</varname> raster catalog. The <varname>rastschema</varname> is the name of the table schema the table resides in. The <varname>srid</varname> must be an integer value reference to an entry in the SPATIAL_REF_SYS table.
fr: Génère des contraintes pour une colonne raster, qui peuvent être utilisées pour afficher des informations depuis le catalogue raster <varname>raster_columns</varname>. <varname>rastschema</varname> est le nom du schéma de la table. <varname>srid</varname> doit être un entier défini dans la table SPATIAL_REF_SYS.

note: Tag: para
en: <varname>raster2pgsql</varname> loader uses this function to register raster tables
fr: Le chargeur de rasters <varname>raster2pgsql</varname> utilise cette fonction pour enregistrer les tables raster

note: Tag: para
en: Valid constraint names to pass in: refer to <xref linkend="RT_Raster_Columns"/> for more details.
fr: Noms de contraintes à passer en arguments : se référer à <xref linkend="RT_Raster_Columns"/> pour plus de détails.

note: Tag: para
en: <varname>blocksize</varname> sets both X and Y blocksize
fr: <varname>blocksize</varname> défini la largeur en X et en Y

note: Tag: para
en: <varname>blocksize_x</varname> sets X tile (width in pixels of each tile)
fr: <varname>blocksize_x</varname> défini la largeur (nombre de pixels) de chaque tuile raster

note: Tag: para
en: <varname>blocksize_y</varname> sets Y tile (height in pixels of each tile)
fr: <varname>blocksize_y</varname> défini la hauteur (nombre de pixels vers le bas) de chaque tuile raster

note: Tag: para
en: <varname>extent</varname> computes extent of whole table and applys constraint all rasters must be within that extent
fr: <varname>extent</varname> calcule l'étendue de l'ensemble de la table et contraint tous les rasters à être inclus dans cette étendue

note: Tag: para
en: <varname>num_bands</varname> number of bands
fr: <varname>num_bands</varname> nombre de bandes

note: Tag: para
en: <varname>pixel_types</varname> reads array of pixel types for each band ensure all band n have same pixel type
fr: <varname>pixel_types</varname> tableau de types de pixels pour chaque bande - contraint chaque bande n au même type de pixels

note: Tag: para
en: <varname>regular_blocking</varname> sets spatially unique (no two rasters can be spatially the same) and coverage tile (raster is aligned to a coverage) constraints
fr: <varname>regular_blocking</varname> défini les contraintes d'unité spatiale (deux rasters ne peuvent pas être spatialement identiques) et de couverture de tuiles (raster est aligné sur une couverture)

note: Tag: para
en: <varname>same_alignment</varname> ensures they all have same alignment meaning any two tiles you compare will return true for. Refer to <xref linkend="RT_ST_SameAlignment"/>.
fr: <varname>same_alignment</varname> garantie que toutes les tuiles ont le même alignement. Comparer n'importe quel couple de tuiles retournera true. Voir <xref linkend="RT_ST_SameAlignment"/> pour plus de détails.

note: Tag: para
en: <varname>srid</varname> ensures all have same srid
fr: <varname>srid</varname> garantie que tous les rasters ont le même srid

note: Tag: para
en: More -- any listed as inputs into the above functions
fr: Plus -- n'importe quelle contrainte listée parmi les arguments des fonctions décrites ci-dessus

note: Tag: para
en: This function infers the constraints from the data already present in the table. As such for it to work, you must create the raster column first and then load it with data.
fr: Cette fonction infère les contraintes depuis les données déjà présentes dans la table. Ainsi, vous devez d'abord créer la colonne raster et charger des données dedans avant de pouvoir utiliser cette fonction.

note: Tag: para
en: If you need to load more data in your tables after you have already applied constraints, you may want to run the DropRasterConstraints if the extent of your data has changed.
fr: Si vous avez besoin de charger plus de données dans la table après avoir défini les contraintes, vous pourrez avoir besoin d'exécuter la fonction DropRasterConstraints avant le chargement, en particulier si l'étendue des données est modifiée.

note: Tag: para
en: Availability: 2.0.0
fr: Disponibilité : 2.0.0

note: Tag: title
en: Examples: Apply all possible constraints on column based on data
fr: Exemples : Appliquer toutes les contraintes possibles à partir des données présentes

note: Tag: title
en: Examples: Apply single constraint
fr: Exemples : Appliquer une seule contrainte

note: Tag: refpurpose
en: Drops PostGIS raster constraints that refer to a raster table column. Useful if you need to reload data or update your raster column data.
fr: Supprime des contraintes raster PostGIS raster sur une colonne raster d'une table. Utile pour recharger des données ou mettre à jour les données d'une colonne raster.

note: Tag: para
en: Drops PostGIS raster constraints that refer to a raster table column that were added by <xref linkend="RT_AddRasterConstraints"/>. Useful if you need to load more data or update your raster column data. You do not need to do this if you want to get rid of a raster table or a raster column.
fr: Supprime des contraintes raster PostGIS ajoutées via <xref linkend="RT_AddRasterConstraints"/> sur une colonne raster d'une table. Utile pour recharger des données ou mettre à jour les données d'une colonne raster. Vous n'avez pas besoin d'appeler cette fonction si vous voulez supprimer une table raster ou une colonne raster.

note: Tag: para
en: To drop a raster table use the standard
fr: Pour supprimer une table raster, utilisez la requête classique

note: Tag: para
en: To drop just a raster column and leave the rest of the table, use standard SQL
fr: Pour supprimer une colonne raster et garder le reste de la table intacte, utilisez la requête classique

note: Tag: para
en: the table will disappear from the <varname>raster_columns</varname> catalog if the column or table is dropped. However if only the constraints are dropped, the raster column will still be listed in the <varname>raster_columns</varname> catalog, but there will be no other information about it aside from the column name and table.
fr: La table disparaîtra du catalogue <varname>raster_columns</varname> si la colonne ou la table est supprimée. Si seulement les contraintes ont été supprimées, la colonne raster sera toujours listée dans le catalogue <varname>raster_columns</varname>, mais il n'y aura pas d'autre information que les noms de la colonne et de la table.

note: Tag: title
en: Examples
fr: Exemples

note: Tag: refpurpose
en: Tag a raster column as being an overview of another.
fr: Marque une colonne raster comme étant un aperçu d'une autre colonne.

note: Tag: para
en: Adds constraints on a raster column that are used to display information in the <varname>raster_overviews</varname> raster catalog.
fr: Ajoute des contraintes sur une colonne raster, qui peuvent être utilisées pour afficher des informations depuis le catalogue raster <varname>raster_overviews</varname>.

note: Tag: para
en: The <varname>ovfactor</varname> parameter represents the scale multiplier in the overview column: higher overview factors have lower resolution.
fr: La paramètre <varname>ovfactor</varname> représente le facture de multiplication d'échelle pour la colonne d'aperçu : plus le facteur d'aperçu est élevé, plus résolution est basse.

note: Tag: para
en: When the <varname>ovschema</varname> and <varname>refschema</varname> parameters are omitted, the first table found scanning the <varname>search_path</varname> will be used.
fr: Si les paramètres <varname>ovschema</varname> et <varname>refschema</varname> sont omis, la première table trouvée lors du scan de <varname>search_path</varname> sera utilisée.

note: Tag: refpurpose
en: Untag a raster column from being an overview of another.
fr: Supprime les contraintes d'aperçu de la colonne.

note: Tag: para
en: Remove from a raster column the constraints used to show it as being an overview of another in the <varname>raster_overviews</varname> raster catalog.
fr: Supprime dans le catalogue raster <varname>raster_overviews</varname> les contraintes raster de la colonne indiquant que c'est un aperçu une autre colonne.

note: Tag: para
en: When the <varname>ovschema</varname> parameter is omitted, the first table found scanning the <varname>search_path</varname> will be used.
fr: Si le paramètre <varname>ovschema</varname> est omis, la première table trouvée lors du scan de <varname>search_path</varname> sera utilisée.

note: Tag: refpurpose
en: Reports the version of the GDAL library in use by PostGIS.
fr: Retourne la version de la bibliothèque GDAL utilisée par PostGIS.

note: Tag: para
en: Reports the version of the GDAL library in use by PostGIS. Will also check and report if GDAL can find its data files.
fr: Retourne la version de la bibliothèque GDAL utilisée par PostGIS. Vérifie également si GDAL peut accéder à ses fichiers de données et reportera une erreur si ce n'est pas le cas.

note: Tag: refpurpose
en: Reports full raster library build date.
fr: Retourne la date de compilation de la bibliothèque raster.

note: Tag: para
en: Reports raster build date
fr: Retourne la date de compilation de la bibliothèque raster

note: Tag: refpurpose
en: <refpurpose>Reports full raster version and build configuration infos.</refpurpose>
fr: <refpurpose>Retourne la version complète de la bibliothèque raster et les informations sur la configuration de la compilation.</refpurpose>

note: Tag: para
en: <para>Reports full raster version and build configuration infos.</para>
fr: <para>Retourne la version complète de la bibliothèque raster et les informations sur la configuration de la compilation.</para>

note: Tag: refpurpose
en: Returns a list of raster formats supported by PostGIS through GDAL. Only those formats with can_write=True can be used by ST_AsGDALRaster
fr: Retourne la liste des formats raster supportés par PostGIS via GDAL. Seuls les formats avec can_write=True peuvent être utilisés par ST_AsGDALRaster

note: Tag: para
en: Returns a list of raster formats short_name,long_name and creator options of each format supported by GDAL. Use the short_name as input in the <varname>format</varname> parameter of <xref linkend="RT_ST_AsGDALRaster"/>. Options vary depending on what drivers your libgdal was compiled with. <varname>create_options</varname> returns an xml formatted set of CreationOptionList/Option consisting of name and optional <varname>type</varname>, <varname>description</varname> and set of <varname>VALUE</varname> for each creator option for the specific driver.
fr: Retourne la liste des formats raster supportés par GDAL, sous forme short_name, long_name et creator. Vous pouvez utiliser short_name comme paramètre <varname>format</varname> pour <xref linkend="RT_ST_AsGDALRaster"/>. Les options peuvent varier selon les drivers compilés dans votre bibliothèque libgdal. <varname>create_options</varname> retourne un XML contenant un ensemble de CreationOptionList/Option avec comme attribut name et comme attributs optionnels <varname>type</varname> et <varname>description</varname>, ainsi qu'un ensemble de <varname>VALUE</varname> pour chaque option de création pour ce driver.

note: Tag: para
en: Changed: 2.5.0 - add can_read and can_write columns.
fr: Changement : 2.5.0 - ajout des colonnes can_read et can_write.

note: Tag: para
en: Changed: 2.0.6, 2.1.3 - by default no drivers are enabled, unless GUC or Environment variable gdal_enabled_drivers is set.
fr: Changement : 2.0.6, 2.1.3 - aucun driver n'est activé par défaut, sauf si la variable GUC ou d'environnement gdal_enabled_drivers est définie.

note: Tag: para
en: Availability: 2.0.0 - requires GDAL &gt;= 1.6.0.
fr: Disponibilité : 2.0.0 - nécessite GDAL &gt;= 1.6.0.

note: Tag: title
en: Examples: List of Drivers
fr: Exemples : Liste des drivers

note: Tag: title
en: Example: List of options for each driver
fr: Exemple : Liste des options pour chaque driver

note: Tag: refpurpose
en: <refpurpose>Generates a set of vector contours from the provided raster band, using the <ulink url="https://gdal.org/api/gdal_alg.html?highlight=contour#_CPPv421GDALContourGenerateEx15GDALRasterBandHPv12CSLConstList16GDALProgressFuncPv">GDAL contouring algorithm</ulink>.</refpurpose>
fr: <refpurpose>Génère un ensemble de courbes de niveau vectorielles depuis la bande raster spécifiée, en utilisant <ulink url="https://gdal.org/api/gdal_alg.html?highlight=contour#_CPPv421GDALContourGenerateEx15GDALRasterBandHPv12CSLConstList16GDALProgressFuncPv">l'algorithme de contour GDAL</ulink>.</refpurpose>

note: Tag: para
en: <para>Generates a set of vector contours from the provided raster band, using the <ulink url="https://gdal.org/api/gdal_alg.html?highlight=contour#_CPPv421GDALContourGenerateEx15GDALRasterBandHPv12CSLConstList16GDALProgressFuncPv">GDAL contouring algorithm</ulink>.</para>
fr: <para>Génère un ensemble de courbes de niveau vectorielles depuis la bande raster spécifiée, en utilisant <ulink url="https://gdal.org/api/gdal_alg.html?highlight=contour#_CPPv421GDALContourGenerateEx15GDALRasterBandHPv12CSLConstList16GDALProgressFuncPv">l'algorithme de contour GDAL</ulink>.</para>

note: Tag: para
en: When the <varname>fixed_levels</varname> parameter is a non-empty array, the <varname>level_interval</varname> and <varname>level_base</varname> parameters are ignored.
fr: Si le paramètre <varname>fixed_levels</varname> est un tableau non vide, les paramètres <varname>level_interval</varname> et <varname>level_base</varname> sont ignorés.

note: Tag: para
en: Input parameters are:
fr: Les paramètres d'entrée sont :

note: Tag: para
en: Return values are a set of records with the following attributes:
fr: La valeur de retour est un ensemble de résultats avec les attributs suivants :

note: Tag: para
en: The geometry of the contour line.
fr: La géométrie de la ligne de contour.

note: Tag: para
en: A unique identifier given to the contour line by GDAL.
fr: Un identifiant unique de la ligne de contour, déterminée par GDAL.

note: Tag: para
en: The raster value the line represents. For an elevation DEM input, this would be the elevation of the output contour.
fr: La valeur raster représentée par la ligne. Pour un modèle numérique de terrain, la valeur correspond à l'élévation du contour.

note: Tag: para
en: Availability: 3.2.0
fr: Disponibilité : 3.2.0

note: Tag: title
en: Example
fr: Exemple

note: Tag: refpurpose
en: Interpolates a gridded surface based on an input set of 3-d points, using the X- and Y-values to position the points on the grid and the Z-value of the points as the surface elevation.
fr: Interpole une surface quadrillée à partir d'un ensemble de points 3-d, en utilisant les coordonnées X et Y des points sur la grille et la coordonnée Z des points pour l'élévation des points.

note: Tag: para
en: Interpolates a gridded surface based on an input set of 3-d points, using the X- and Y-values to position the points on the grid and the Z-value of the points as the surface elevation. There are five interpolation algorithms available: inverse distance, inverse distance nearest-neighbor, moving average, nearest neighbor, and linear interpolation. See the <ulink url="https://gdal.org/programs/gdal_grid.html#interpolation-algorithms">gdal_grid documentation</ulink> for more details on the algorithms and their parameters. For more information on how interpolations are calculated, see the <ulink url="https://gdal.org/tutorials/gdal_grid_tut.html">GDAL grid tutorial</ulink>.
fr: Interpole une surface quadrillée à partir d'un ensemble de points 3-d, en utilisant les coordonnées X et Y des points sur la grille et la coordonnée Z des points pour l'élévation des points. 5 algorithmes d'interpolations sont disponibles : inverse de la distance, inverse de la distance avec plus proche voisin, moyenne mobile, plus proche voisin, et interpolation linéaire. Voir <ulink url="https://gdal.org/programs/gdal_grid.html#interpolation-algorithms">gdal_grid documentation</ulink> pour plus de détails sur ces algorithmes et leurs paramètres. Pour plus d'informations sur le calcul des interpolations, voir le <ulink url="https://gdal.org/tutorials/gdal_grid_tut.html">tutorial GDAL grid</ulink>.

note: Tag: para
en: The points to drive the interpolation. Any geometry with Z-values is acceptable, all points in the input will be used.
fr: Les points pour effectuer l'interpolation. Toute géometrie avec une dimension Z est acceptée ; tous les points de la géométrie seront utilisés.

note: Tag: para
en: A string defining the algorithm and algorithm options, in the format used by <ulink url="https://gdal.org/programs/gdal_grid.html#interpolation-algorithms">gdal_grid</ulink>. For example, for an inverse-distance interpolation with a smoothing of 2, you would use "invdist:smoothing=2.0"
fr: Une chaîne définissant l'algorithme et ses options, au format utilisable par <ulink url="https://gdal.org/programs/gdal_grid.html#interpolation-algorithms">gdal_grid</ulink>. Par exemple, pour une interpolation en inverse de la distance avec un lissage de 2, la valeur sera "invdist:smoothing=2.0"

note: Tag: para
en: A raster template to drive the geometry of the output raster. The width, height, pixel size, spatial extent and pixel type will be read from this template.
fr: Un gabarit raster pour la création du raster de sortie. Les largeur, hauteur, taille des pixels, étendue spatiale et type des pixels seront définis à partir de ce gabarit.

note: Tag: para
en: By default the first band in the template raster is used to drive the output raster, but that can be adjusted with this parameter.
fr: Indice de la bande raster du gabarit raster à utiliser ; par défaut, la première bande sera utilisée.

note: Tag: refpurpose
en: Change the SRID of all rasters in the user-specified column and table.
fr: Change le SRID de tous les rasters dans la table et colonne en paramètres.

note: Tag: para
en: Change the SRID of all rasters in the user-specified column and table. The function will drop all appropriate column constraints (extent, alignment and SRID) before changing the SRID of the specified column's rasters.
fr: Change le SRID de tous les rasters dans la table et colonne en paramètres. Cette fonction supprimera toutes les contraintes nécessaires (étendue, alignement et SRID) avant de changer le SRID de la colonne raster.

note: Tag: para
en: The data (band pixel values) of the rasters are not touched by this function. Only the raster's metadata is changed.
fr: Les données (les valeurs des pixels) des rasters ne sont pas changées par cette fonction. Seules les métadonnées du rasters sont modifiées.

note: Tag: para
en: Availability: 2.1.0
fr: Disponibilité : 2.1.0

note: Tag: refpurpose
en: Create an reduced resolution version of a given raster coverage.
fr: Créé une version à plus faible résolution d'une colonne raster.

note: Tag: para
en: Create an overview table with resampled tiles from the source table. Output tiles will have the same size of input tiles and cover the same spatial extent with a lower resolution (pixel size will be 1/<varname>factor</varname> of the original in both directions).
fr: Créé une table d'aperçu avec les tuiles rééchantillonnées depuis la table source. Les tuiles de sortie auront la même taille que les tuiles d'entrées et couvriront la même étendue, mais avec une résolution plus faible (la taille d'un pixel sera 1/<varname>factor</varname> dans les deux directions).

note: Tag: para
en: The overview table will be made available in the <varname>raster_overviews</varname> catalog and will have raster constraints enforced.
fr: La table d'aperçu sera disponible dans le catalogue <varname>raster_overviews</varname> avec les contraintes rasters ajoutées.

note: Tag: para
en: Algorithm options are: 'NearestNeighbor', 'Bilinear', 'Cubic', 'CubicSpline', and 'Lanczos'. Refer to: <ulink url="http://www.gdal.org/gdalwarp.html">GDAL Warp resampling methods</ulink> for more details.
fr: Les algorithmes disponibles sont : 'NearestNeighbor' (plus proche voisin), 'Bilinear' (Bilinéaire), 'Cubic' (Cubique), 'CubicSpline' (Cubique Spline) et 'Lanczos'. Voir <ulink url="http://www.gdal.org/gdalwarp.html">GDAL Warp resampling methods</ulink> pour plus de détails.

note: Tag: para
en: Availability: 2.2.0
fr: Disponibilité : 2.2.0

note: Tag: para
en: Output to generally better quality but slower to product format
fr: Sortie de meilleure qualité en général, mais plus lent à générer

note: Tag: para
en: Output to faster to process default nearest neighbor
fr: Sortie plus rapide, via la méthode de plus proche voisin

note: Tag: title
en: Raster Constructors
fr: Constructeurs de raster

note: Tag: refpurpose
en: Returns a raster with the new band(s) of given type added with given initial value in the given index location. If no index is specified, the band is added to the end.
fr: Retourne un raster avec la/les nouvelle(s) bande(s) ajouté(s) à un index donné, de type et valeur initiale donnés. Si aucun index n'est spécifié, la bande est ajoutée à la fin.

note: Tag: para
en: Returns a raster with a new band added in given position (index), of given type, of given initial value, and of given nodata value. If no index is specified, the band is added to the end. If no <varname>fromband</varname> is specified, band 1 is assumed. Pixel type is a string representation of one of the pixel types specified in <xref linkend="RT_ST_BandPixelType"/>. If an existing index is specified all subsequent bands >= that index are incremented by 1. If an initial value greater than the max of the pixel type is specified, then the initial value is set to the highest value allowed by the pixel type.
fr: Retourne un raster avec la nouvelle bande ajoutée à l'index donné, de type, valeur initiale et valeur nodata donnés. Si aucun index n'est spécifié, la bande est ajoutée à la fin. Si le paramètre <varname>fromband</varname> n'est pas spécifié, la bande 1 est utilisée. Le type de pixel est une chaîne contenant un des types de pixels tels que décrits dans <xref linkend="RT_ST_BandPixelType"/>. Si un index existant est spécifié, alors toutes les bandes ayant un index plus grand ou égal auront leur index incrémenté de 1. Si la valeur initiale donnée est plus grande que le maximum autorisé pour le type de pixel spécifié, alors la valeur initiale sera la valeur maximale autorisée pour le type de pixel.

note: Tag: para
en: For the variant that takes an array of <xref linkend="addbandarg"/> (Variant 1), a specific addbandarg's index value is relative to the raster at the time when the band described by that addbandarg is being added to the raster. See the Multiple New Bands example below.
fr: Pour la variante acceptant un tableau de <xref linkend="addbandarg"/> en paramètre (Variante 1), un index spécifique au paramètre addbandarg est relative au raster au moment où la bande décrite par ce paramètre addbandarg est ajoutée au raster. Voir l'exemple Multiples nouvelles bandes ci-dessous.

note: Tag: para
en: For the variant that takes an array of rasters (Variant 5), if <varname>torast</varname> is NULL then the <varname>fromband</varname> band of each raster in the array is accumulated into a new raster.
fr: Pour la variante acceptant un tableau de rasters (Variante 5), si <varname>torast</varname> est NULL, alors la bande <varname>fromband</varname> de chaque raster est accumulée dans le nouveau raster.

note: Tag: para
en: For the variants that take <varname>outdbfile</varname> (Variants 6 and 7), the value must include the full path to the raster file. The file must also be accessible to the postgres server process.
fr: Pour les variantes acceptant un paramètre <varname>outdbfile</varname> (Variantes 6 et 7), la valeur doit correspondre au chemin complet vers le fichier raster. Ce fichier doit être accessible par le processus du serveur postgres.

note: Tag: para
en: Enhanced: 2.1.0 support for addbandarg added.
fr: Amélioration : 2.1.0 ajout du paramètre addbandarg.

note: Tag: para
en: Enhanced: 2.1.0 support for new out-db bands added.
fr: Amélioration : 2.1.0 introduction du support des bandes out-db.

note: Tag: title
en: Examples: Single New Band
fr: Exemples : Nouvelle bande

note: Tag: title
en: Examples: Multiple New Bands
fr: Exemples : Multiples nouvelles bandes

note: Tag: title
en: Examples: New Out-db band
fr: Exemples : Nouvelle bande Out-db

note: Tag: refpurpose
en: Converts a PostGIS geometry to a PostGIS raster.
fr: Convertit une géométrie PostGIS en un raster PostGIS.

note: Tag: para
en: Converts a PostGIS geometry to a PostGIS raster. The many variants offers three groups of possibilities for setting the alignment and pixelsize of the resulting raster.
fr: Convertit une géométrie PostGIS en un raster PostGIS. Les nombreuses variantes permettent trois groupes de possibilités pour définir l'alignement et la taille des pixels du raster en sortie.

note: Tag: para
en: The first group, composed of the two first variants, produce a raster having the same alignment (<varname>scalex</varname>, <varname>scaley</varname>, <varname>gridx</varname> and <varname>gridy</varname>), pixel type and nodata value as the provided reference raster. You generally pass this reference raster by joining the table containing the geometry with the table containing the reference raster.
fr: Le premier groupe, constitué des deux premières variantes, produit un raster avec le même alignement (<varname>scalex</varname>, <varname>scaley</varname>, <varname>gridx</varname> et <varname>gridy</varname>), le même type de pixels et la même valeur nodata que le raster donné en référence. En général, vous passerez cette référence en faisant une jointure entre la table contenant la géométrie avec la table contenant le raster de référence.

note: Tag: para
en: The second group, composed of four variants, let you set the dimensions of the raster by providing the parameters of a pixel size (<varname>scalex</varname> &amp; <varname>scaley</varname> and <varname>skewx</varname> &amp; <varname>skewy</varname>). The <varname>width</varname> &amp; <varname>height</varname> of the resulting raster will be adjusted to fit the extent of the geometry. In most cases, you must cast integer <varname>scalex</varname> &amp; <varname>scaley</varname> arguments to double precision so that PostgreSQL choose the right variant.
fr: Le second groupe, composé de quatre variantes, vous permettent de spécifier les dimensions du raster via les paramètres de taille de pixel (<varname>scalex</varname> &amp; <varname>scaley</varname> et <varname>skewx</varname> &amp; <varname>skewy</varname>). Les dimensions <varname>width</varname> &amp; <varname>height</varname> du raster résultant seront ajustés pour s'adapter à l'étendu de la géométrie. Dans la plupart des cas, vous devrez transtyper les paramètres <varname>scalex</varname> &amp; <varname>scaley</varname> de integer à double precision pour que PostgreSQL choisisse la variante correcte.

note: Tag: para
en: The third group, composed of four variants, let you fix the dimensions of the raster by providing the dimensions of the raster (<varname>width</varname> &amp; <varname>height</varname>). The parameters of the pixel size (<varname>scalex</varname> &amp; <varname>scaley</varname> and <varname>skewx</varname> &amp; <varname>skewy</varname>) of the resulting raster will be adjusted to fit the extent of the geometry.
fr: Le troisième groupe, composé de quatre variantes, vous permettent de spécifier les dimensions du raster directement (<varname>width</varname> &amp; <varname>height</varname>). Les paramètres de taille de pixel (<varname>scalex</varname> &amp; <varname>scaley</varname> et <varname>skewx</varname> &amp; <varname>skewy</varname>) du raster résultant seront ajustés pour s'adapter à l'étendue de la géométrie.

note: Tag: para
en: The two first variants of each of those two last groups let you specify the alignment with an arbitrary corner of the alignment grid (<varname>gridx</varname> &amp; <varname>gridy</varname>) and the two last variants takes the upper left corner (<varname>upperleftx</varname> &amp; <varname>upperlefty</varname>).
fr: Les deux premières variantes des deux derniers groupes vous permettent de spécifier l'alignement avec un coin arbitraire de la grille d'alignement (<varname>gridx</varname> &amp; <varname>gridy</varname>) et les deux dernières variantes via le coin haut-gauche (<varname>upperleftx</varname> &amp; <varname>upperlefty</varname>).

note: Tag: para
en: Each group of variant allows producing a one band raster or a multiple bands raster. To produce a multiple bands raster, you must provide an array of pixel types (<varname>pixeltype[]</varname>), an array of initial values (<varname>value</varname>) and an array of nodata values (<varname>nodataval</varname>). If not provided pixeltyped defaults to 8BUI, values to 1 and nodataval to 0.
fr: Chaque groupe de variantes permet de produire un raster à une ou plusieurs bandes. Pour plusieurs bandes, vous devez fournir un tableau de types de pixels (<varname>pixeltype[]</varname>), un tableau de valeurs initiales (<varname>value</varname>) et un tableau de valeurs nodata (<varname>nodataval</varname>). Si non fournis, pixeltype est par défaut à 8BUI, value à 1 et nodataval à 0.

note: Tag: para
en: The output raster will be in the same spatial reference as the source geometry. The only exception is for variants with a reference raster. In this case the resulting raster will get the same SRID as the reference raster.
fr: Le raster en sortie aura le même système de référence spatial que la géométrie source, sauf pour les variantes utilisant un raster de référence. Dans ce cas, le raster en sortie aura le même SRID que le raster de référence.

note: Tag: para
en: The optional <varname>touched</varname> parameter defaults to false and maps to the GDAL ALL_TOUCHED rasterization option, which determines if pixels touched by lines or polygons will be burned. Not just those on the line render path, or whose center point is within the polygon.
fr: Le paramètre optionnel <varname>touched</varname> est par défaut à false et correspond à l'option GDAL ALL_TOUCHED, qui détermine si les pixels touchés par des lignes ou polygones seront mis à jour, et pas seulement ceux sur le chemin de la ligne ou dont le point central est dans le polygone.

note: Tag: para
en: This is particularly useful for rendering jpegs and pngs of geometries directly from the database when using in combination with <xref linkend="RT_ST_AsPNG"/> and other <xref linkend="RT_ST_AsGDALRaster"/> family of functions.
fr: Ceci est particulièrement utile pour le rendu de JPEGs et de PNGs directement depuis la base de données en utilisant une combinaison de <xref linkend="RT_ST_AsPNG"/> et des fonctions de la famille de <xref linkend="RT_ST_AsGDALRaster"/>.

note: Tag: para
en: Not yet capable of rendering complex geometry types such as curves, TINS, and PolyhedralSurfaces, but should be able too once GDAL can.
fr: Pas encore en mesure de faire le rendu de géométries complexes comme les CURVES, TIN et PolyhedralSurfaces, mais cela devrait être le cas lorsque GDAL le supportera.

note: Tag: title
en: Examples: Output geometries as PNG files
fr: Exemples : Rendu de géométries en fichiers PNG

note: Tag: para
en: black circle
fr: cercle noir

note: Tag: para
en: example from buffer rendered with just PostGIS
fr: exemple d'un buffer rendu via PostGIS

note: Tag: refpurpose
en: Returns one or more bands of an existing raster as a new raster. Useful for building new rasters from existing rasters.
fr: Retourne une ou plusieurs bandes d'un raster existant en tant que nouveau raster. Utile pour construire de nouveaux rasters à partir de rasters existants.

note: Tag: para
en: Returns one or more bands of an existing raster as a new raster. Useful for building new rasters from existing rasters or export of only selected bands of a raster or rearranging the order of bands in a raster. If no band is specified or any of specified bands does not exist in the raster, then all bands are returned. Used as a helper function in various functions such as for deleting a band.
fr: Retourne une ou plusieurs bandes d'un raster existant en tant que nouveau raster. Utile pour construire de nouveaux rasters à partir de rasters existants ou pour exporter certaines bandes d'un raster, ou pour réarranger l'ordre des bandes d'un raster. Si aucune bande n'est spécifiée, ou si aucune des bandes spécifiées n'existent dans le raster, alors toutes les bandes sont retournées. Cette fonction est utilisée en interne par diverses fonctions, comme pour supprimer une bande.

note: Tag: para
en: For the <code>nbands</code> as text variant of function, the default delimiter is <code>,</code> which means you can ask for <code>'1,2,3'</code> and if you wanted to use a different delimeter you would do <code>ST_Band(rast, '1@2@3', '@')</code>. For asking for multiple bands, we strongly suggest you use the array form of this function e.g. <code>ST_Band(rast, '{1,2,3}'::int[]);</code> since the <code>text</code> list of bands form may be removed in future versions of PostGIS.
fr: Pour les variantes avec le paramètre <code>nbands</code> en texte, le délimiteur par défaut est <code>,</code>, il faut donc passer par exemple <code>'1,2,3'</code>. Pour utiliser un autre délimiteur, utilisez le paramètre delimiter : <code>ST_Band(rast, '1@2@3', '@')</code>. Néanmoins, pour utiliser plusieurs bandes, nous encourageons fortement d'utiliser la variante avec le paramètre de type tableau (e.g. <code>ST_Band(rast, '{1,2,3}'::int[]);</code>); la variante avec la liste de bandes en <code>text</code> peut être supprimée des prochaines versions de PostGIS.

note: Tag: para
en: original (column rast)
fr: originale (colonne rast)

note: Tag: refpurpose
en: Cover georeferenced area with a grid of empty raster tiles.
fr: Couvre une zone géo-référencée avec une grille raster de tuiles vides.

note: Tag: para
en: Create a set of raster tiles with <xref linkend="RT_ST_MakeEmptyRaster"/>. Grid dimension is <varname>width</varname> &amp; <varname>height</varname>. Tile dimension is <varname>tilewidth</varname> &amp; <varname>tileheight</varname>. The covered georeferenced area is from upper left corner (<varname>upperleftx</varname>, <varname>upperlefty</varname>) to lower right corner (<varname>upperleftx</varname> + <varname>width</varname> * <varname>scalex</varname>, <varname>upperlefty</varname> + <varname>height</varname> * <varname>scaley</varname>).
fr: Créé un ensemble de tuiles rasters via <xref linkend="RT_ST_MakeEmptyRaster"/>. La dimension de la grille est définie par <varname>width</varname> &amp; <varname>height</varname>. La dimension des tuiles est définie par <varname>tilewidth</varname> &amp; <varname>tileheight</varname>. La zone géo-référencée couverte démarre au coin supérieur gauche (<varname>upperleftx</varname>, <varname>upperlefty</varname>) jusqu'au coin inférieur droit (<varname>upperleftx</varname> + <varname>width</varname> * <varname>scalex</varname>, <varname>upperlefty</varname> + <varname>height</varname> * <varname>scaley</varname>).

note: Tag: para
en: Note that scaley is generally negative for rasters and scalex is generally positive. So lower right corner will have a lower y value and higher x value than the upper left corner.
fr: A noter que scaley est généralement négatif pour les rasters, alors que scalex est généralement positif. Le coin inférieur droit aura une valeur Y inférieure et une valeur X supérieure au coin supérieur gauche.

note: Tag: para
en: Availability: 2.4.0
fr: Disponibilité : 2.4.0

note: Tag: title
en: Examples Basic
fr: Exemples de base

note: Tag: para
en: Create 16 tiles in a 4x4 grid to cover the WGS84 area from upper left corner (22, 77) to lower right corner (55, 33).
fr: Créer 16 tuiles de 1x1px dans une grille 4x4 pour couvrir une zone WGS84 du coin supérieur gauche (22, 77) jusqu'au coin inférieur droit (55, 33).

note: Tag: refpurpose
en: Returns an empty raster (having no bands) of given dimensions (width &amp; height), upperleft X and Y, pixel size and rotation (scalex, scaley, skewx &amp; skewy) and reference system (srid). If a raster is passed in, returns a new raster with the same size, alignment and SRID. If srid is left out, the spatial ref is set to unknown (0).
fr: Retourne un raster vide (sans aucune bande) de dimension donnée (width &amp; height), de coin supérieur gauche à X et Y, de paramètres de taille de pixel données (scalex, scaley, skewx &amp; skewy) et de système de référence spatial (srid) donné. Si un raster est spécifié, retourne un nouveau raster de même taille, alignement et SRID. Si srid n'est pas spécifié, le système de référence spatial est défini à inconnu (0).

note: Tag: para
en: Returns an empty raster (having no band) of given dimensions (width &amp; height) and georeferenced in spatial (or world) coordinates with upper left X (upperleftx), upper left Y (upperlefty), pixel size and rotation (scalex, scaley, skewx &amp; skewy) and reference system (srid).
fr: Retourne un raster vide (sans aucune bande) de dimension donnée (width &amp; height), géo-référencé via le coin supérieur gauche (upperleftx &amp; upperlefty), via les paramètres de taille de pixel données (scalex, scaley, skewx &amp; skewy) et via le système de référence spatial (srid) donné.

note: Tag: para
en: The last version use a single parameter to specify the pixel size (pixelsize). scalex is set to this argument and scaley is set to the negative value of this argument. skewx and skewy are set to 0.
fr: La dernière variante utilise un seul paramètre pour spécifier la taille des pixels (pixelsize). scalex est défini à la valeur de ce paramètre et scaley est défini à la valeur négative de ce paramètre. skewx et skewy sont définis à 0.

note: Tag: para
en: If an existing raster is passed in, it returns a new raster with the same meta data settings (without the bands).
fr: Si un raster existant est spécifié, retourne un nouveau raster avec les mêmes métadonnées (sans aucune bande).

note: Tag: para
en: If no srid is specified it defaults to 0. After you create an empty raster you probably want to add bands to it and maybe edit it. Refer to <xref linkend="RT_ST_AddBand"/> to define bands and <xref linkend="RT_ST_SetValue"/> to set initial pixel values.
fr: Si aucun srid n'est spécifié, la valeur 0 est utilisée. Après avoir créé un raster vide, vous voudrez probablement ajouter des bandes ou l'éditer. Voir <xref linkend="RT_ST_AddBand"/> pour définir des bandes et <xref linkend="RT_ST_SetValue"/> pour initialiser des valeurs.

note: Tag: refpurpose
en: <refpurpose>Returns a set of rasters resulting from the split of the input raster based upon the desired dimensions of the output rasters.</refpurpose>
fr: <refpurpose>Retourne un ensemble de rasters issus de la division d'un raster d'entrée selon les dimensions spécifiées pour les rasters de sortie.</refpurpose>

note: Tag: para
en: <para>Returns a set of rasters resulting from the split of the input raster based upon the desired dimensions of the output rasters.</para>
fr: <para>Retourne un ensemble de rasters issus de la division d'un raster d'entrée selon les dimensions spécifiées pour les rasters de sortie.</para>

note: Tag: para
en: If <varname>padwithnodata</varname> = FALSE, edge tiles on the right and bottom sides of the raster may have different dimensions than the rest of the tiles. If <varname>padwithnodata</varname> = TRUE, all tiles will have the same dimensions with the possibility that edge tiles being padded with NODATA values. If raster band(s) do not have NODATA value(s) specified, one can be specified by setting <varname>nodataval</varname>.
fr: Si <varname>padwithnodata</varname> est FALSE, les tuiles des bords droits et bas peuvent avoir des dimensions différentes du reste des tuiles. Si <varname>padwithnodata</varname> est TRUE, toutes les tuiles auront les mêmes dimensions, potentiellement avec les tuiles des bords complétées par la valeur NODATA. Si la bande raster n'a pas de valeur NODATA définie, cette valeur peut être spécifiée via le paramètre <varname>nodataval</varname>.

note: Tag: para
en: If a specified band of the input raster is out-of-db, the corresponding band in the output rasters will also be out-of-db.
fr: Si une bande spécifiée du raster d'entrée est out-of-db, la bande correspondant dans les rasters de sortie sera aussi out-of-db.

note: Tag: refpurpose
en: Return a set of configured tiles from an arbitrarily tiled raster coverage.
fr: Retourne un ensemble de tuiles configurées à partir d'une couverture raster composée de tuiles arbitraires.

note: Tag: para
en: Return a set of tiles having the specified scale (<varname>sfx</varname>, <varname>sfy</varname>) and max size (<varname>tw</varname>, <varname>th</varname>) and covering the specified extent (<varname>ext</varname>) with data coming from the specified raster coverage (<varname>tab</varname>, <varname>col</varname>).
fr: Retourne un ensemble de tuiles ayant l'échelle spécifiée (<varname>sfx</varname>, <varname>sfy</varname>), de taille maximale (<varname>tw</varname>, <varname>th</varname>) et couvrant l'étendue spécifiée (<varname>ext</varname>), et avec les données provenant de la couverture raster spécifiée (<varname>tab</varname>, <varname>col</varname>).

note: Tag: refpurpose
en: Returns a raster from a supported GDAL raster file.
fr: Retourne un raster depuis un fichier raster supporté par GDAL.

note: Tag: para
en: Returns a raster from a supported GDAL raster file. <varname>gdaldata</varname> is of type bytea and should be the contents of the GDAL raster file.
fr: Retourne un raster depuis un fichier raster supporté par GDAL. Le paramètre <varname>gdaldata</varname> de type bytea est le contenu du fichier raster GDAL.

note: Tag: para
en: If <varname>srid</varname> is NULL, the function will try to automatically assign the SRID from the GDAL raster. If <varname>srid</varname> is provided, the value provided will override any automatically assigned SRID.
fr: Si <varname>srid</varname> est NULL, la fonction essaye de déterminer le SRID depuis le raster GDAL. Si <varname>srid</varname> est spécifié, la valeur spécifiée écrase tout SRID déterminé automatiquement.

note: Tag: title
en: Raster Accessors
fr: Fonctions d'accès aux rasters

note: Tag: refpurpose
en: Returns the georeference meta data in GDAL or ESRI format as commonly seen in a world file. Default is GDAL.
fr: Retourne les méta-données de géo-référencement au format GDAL (par défaut) ou ESRI, tel qu'utilisé généralement dans les fichiers world file.

note: Tag: para
en: Returns the georeference meta data including carriage return in GDAL or ESRI format as commonly seen in a <ulink url="http://en.wikipedia.org/wiki/World_file">world file</ulink>. Default is GDAL if no type specified. type is string 'GDAL' or 'ESRI'.
fr: Retourne les méta-données de géo-référencement au format GDAL ou ESRI, tel qu'utilisé généralement dans les fichiers <ulink url="https://fr.wikipedia.org/wiki/World_file">world file</ulink>. Si aucun type n'est spécifié, utilise le format GDAL par défaut. type est une chaîne 'GDAL' ou 'ESRI'.

note: Tag: para
en: Difference between format representations is as follows:
fr: La différence entre les représentations de format est la suivante :

note: Tag: para
en: <varname>GDAL</varname>:
fr: <varname>GDAL</varname> :

note: Tag: para
en: <varname>ESRI</varname>:
fr: <varname>ESRI</varname> :

note: Tag: refpurpose
en: Returns the height of the raster in pixels.
fr: Retourne la hauteur du raster en pixels.

note: Tag: para
en: Returns the height of the raster.
fr: Retourne la hauteur du raster en pixels.

note: Tag: refpurpose
en: <refpurpose>Returns true if the raster is empty (width = 0 and height = 0). Otherwise, returns false.</refpurpose>
fr: <refpurpose>Retourne true si le raster est vide (largeur = 0 et hauteur = 0). Sinon, retourne false.</refpurpose>

note: Tag: para
en: <para>Returns true if the raster is empty (width = 0 and height = 0). Otherwise, returns false.</para>
fr: <para>Retourne true si le raster est vide (largeur = 0 et hauteur = 0). Sinon, retourne false.</para>

note: Tag: refpurpose
en: <refpurpose>Returns the amount of space (in bytes) the raster takes.</refpurpose>
fr: <refpurpose>Retourne l'espace utilisé par le raster (en octets).</refpurpose>

note: Tag: para
en: <para>Returns the amount of space (in bytes) the raster takes.</para>
fr: <para>Retourne l'espace utilisé par le raster (en octets).</para>

note: Tag: para
en: This is a nice compliment to PostgreSQL built in functions pg_column_size, pg_size_pretty, pg_relation_size, pg_total_relation_size.
fr: Cette fonction est un bon complément aux fonctions PostgreSQL natives pg_column_size, pg_size_pretty, pg_relation_size, pg_total_relation_size.

note: Tag: para
en: pg_relation_size which gives the byte size of a table may return byte size lower than ST_MemSize. This is because pg_relation_size does not add toasted table contribution and large geometries are stored in TOAST tables. pg_column_size might return lower because it returns the compressed size.
fr: pg_relation_size qui donne la taille en octets d'une table peut renvoyer une taille en octets inférieure à ST_MemSize. Cela est dû au fait que pg_relation_size n'ajoute pas la contribution des tables toasted et que les grandes géométries sont stockées dans les tables TOAST. pg_column_size peut retourner une valeur inférieure parce qu'elle retourne la taille compressée.

note: Tag: para
en: pg_total_relation_size - includes, the table, the toasted tables, and the indexes.
fr: pg_total_relation_size - comprend la table, les tables toasted et les index.

note: Tag: refpurpose
en: Returns basic meta data about a raster object such as pixel size, rotation (skew), upper, lower left, etc.
fr: Retourne les méta-données de base de l'objet raster : taille des pixels, rotation, coin haut/bas gauche, etc.

note: Tag: para
en: Returns basic meta data about a raster object such as pixel size, rotation (skew), upper, lower left, etc. Columns returned: upperleftx | upperlefty | width | height | scalex | scaley | skewx | skewy | srid | numbands
fr: Retourne les méta-données de base de l'objet raster : taille des pixels, rotation, coin haut/bas gauche, etc. Les colonnes retournées sont : upperleftx | upperlefty | width | height | scalex | scaley | skewx | skewy | srid | numbands

note: Tag: refpurpose
en: <refpurpose>Returns the number of bands in the raster object.</refpurpose>
fr: <refpurpose>Retourne le nombre de bandes de l'objet raster.</refpurpose>

note: Tag: para
en: <para>Returns the number of bands in the raster object.</para>
fr: <para>Retourne le nombre de bandes de l'objet raster.</para>

note: Tag: refpurpose
en: Returns the pixel height in geometric units of the spatial reference system.
fr: Retourne la hauteur d'un pixel, dans l'unité du système de référence spatial.

note: Tag: para
en: Returns the height of a pixel in geometric units of the spatial reference system. In the common case where there is no skew, the pixel height is just the scale ratio between geometric coordinates and raster pixels.
fr: Retourne la hauteur d'un pixel, dans l'unité du système de référence spatial. Dans le cas général où il n'y a pas d'obliquité (skew), la hauteur d'un pixel est simplement l'échelle entre les coordonnées géométriques et les pixels rasters.

note: Tag: para
en: Refer to <xref linkend="RT_ST_PixelWidth"/> for a diagrammatic visualization of the relationship.
fr: Voir <xref linkend="RT_ST_PixelWidth"/> pour une représentation schématique de la relation.

note: Tag: title
en: Examples: Rasters with no skew
fr: Exemples : Rasters sans obliquité (skew)

note: Tag: title
en: Examples: Rasters with skew different than 0
fr: Exemples : Rasters avec obliquité (skew) différent de 0

note: Tag: refpurpose
en: Returns the pixel width in geometric units of the spatial reference system.
fr: Retourne la largeur d'un pixel, dans l'unité du système de référence spatial.

note: Tag: para
en: Returns the width of a pixel in geometric units of the spatial reference system. In the common case where there is no skew, the pixel width is just the scale ratio between geometric coordinates and raster pixels.
fr: Retourne la largeur d'un pixel, dans l'unité du système de référence spatial. Dans le cas général où il n'y a pas d'obliquité (skew), la largeur d'un pixel est simplement l'échelle entre les coordonnées géométriques et les pixels rasters.

note: Tag: para
en: The following diagram demonstrates the relationship:
fr: Le diagramme suivant illustre cette relation :

note: Tag: para
en: Pixel Width: Pixel size in the i direction
fr: Largeur du pixel : taille du pixel dans la direction i

note: Tag: para
en: Pixel Height: Pixel size in the j direction
fr: Hauteur du pixel : taille du pixel dans la direction j

note: Tag: refpurpose
en: Returns the X component of the pixel width in units of coordinate reference system.
fr: Renvoie la composante X de la largeur du pixel dans l'unité du système de référence spatial.

note: Tag: para
en: Returns the X component of the pixel width in units of coordinate reference system. Refer to <ulink url="http://en.wikipedia.org/wiki/World_file">World File</ulink> for more details.
fr: Renvoie la composante X de la largeur du pixel dans l'unité du système de référence spatial. Voir <ulink url="https://fr.wikipedia.org/wiki/World_file">World File</ulink> pour plus de détails.

note: Tag: para
en: Changed: 2.0.0. In WKTRaster versions this was called ST_PixelSizeX.
fr: Changement : 2.0.0. Dans les versions WKTRaster, cette fonction était appelée ST_PixelSizeX.

note: Tag: refpurpose
en: Returns the Y component of the pixel height in units of coordinate reference system.
fr: Renvoie la composante Y de la hauteur du pixel dans l'unité du système de référence spatial.

note: Tag: para
en: Returns the Y component of the pixel height in units of coordinate reference system. May be negative. Refer to <ulink url="http://en.wikipedia.org/wiki/World_file">World File</ulink> for more details.
fr: Renvoie la composante Y de la hauteur du pixel dans l'unité du système de référence spatial. Peut être négative. Voir <ulink url="https://fr.wikipedia.org/wiki/World_file">World File</ulink> pour plus de détails.

note: Tag: para
en: Changed: 2.0.0. In WKTRaster versions this was called ST_PixelSizeY.
fr: Changement : 2.0.0. Dans les versions WKTRaster, cette fonction était appelée ST_PixelSizeY.

note: Tag: refpurpose
en: Returns the raster's upper left corner as geometric X and Y (longitude and latitude) given a column and row. Column and row starts at 1.
fr: Retourne le coin supérieur gauche du raster, sous forme de coordonnées X et Y (longitude et latitude) d'un colonne et d'une ligne. Les numéros de colonne et de ligne commencent à 1.

note: Tag: para
en: Returns the upper left corner as geometric X and Y (longitude and latitude) given a column and row. Returned X and Y are in geometric units of the georeferenced raster. Numbering of column and row starts at 1 but if either parameter is passed a zero, a negative number or a number greater than the respective dimension of the raster, it will return coordinates outside of the raster assuming the raster's grid is applicable outside the raster's bounds.
fr: Retourne le coin supérieur gauche du raster, sous forme de coordonnées X et Y (longitude et latitude) d'un colonne et d'une ligne. Les valeurs X et Y retournées sont dans l'unité du système de référence spatial du raster géo-référencé. Les numéros de colonne et de ligne commencent à 1, mais si l'un des deux paramètres est 0, un nombre négatif ou supérieur à la dimension du raster, la fonction retourne des coordonnées en dehors du raster, en supposant que la grille du raster est applicable en dehors de son étendue.

note: Tag: refpurpose
en: Returns the geometric X coordinate upper left of a raster, column and row. Numbering of columns and rows starts at 1.
fr: Retourne la coordonnée X du coin supérieur gauche du raster à column et row. Les numéros de colonne et de ligne commencent à 1.

note: Tag: para
en: Returns the upper left X coordinate of a raster column row in geometric units of the georeferenced raster. Numbering of columns and rows starts at 1 but if you pass in a negative number or number higher than number of columns in raster, it will give you coordinates outside of the raster file to left or right with the assumption that the skew and pixel sizes are same as selected raster.
fr: Retourne la coordonnée X du coin supérieur gauche du raster à column et row dans l'unité du système de référence spatial du raster géo-référencé. Les numéros de colonne et de ligne commencent à 1, mais si l'un des deux paramètres est 0, un nombre négatif ou supérieur à la dimension du raster, la fonction retourne des coordonnées en dehors du raster, en supposant que la grille du raster est applicable en dehors de son étendue (même taille de pixel et skew).

note: Tag: para
en: For non-skewed rasters, providing the X column is sufficient. For skewed rasters, the georeferenced coordinate is a function of the ST_ScaleX and ST_SkewX and row and column. An error will be raised if you give just the X column for a skewed raster.
fr: Pour des rasters sans obliquité (skew), fournir le numéro de colonne X est suffisant. Pour des rasters avec obliquité, les coordonnées géo-référencées sont fonction de ST_ScaleX et ST_SkewX et de la ligne et colonne. Une erreur sera émise si seulement la colonne X est fournie pour une raster avec obliquité.

note: Tag: para
en: Changed: 2.1.0 In prior versions, this was called ST_Raster2WorldCoordX
fr: Changement : 2.1.0 Jusqu'à la version 2.0.x, cette fonction était appelée ST_Raster2WorldCoordX

note: Tag: refpurpose
en: Returns the geometric Y coordinate upper left corner of a raster, column and row. Numbering of columns and rows starts at 1.
fr: Retourne la coordonnée Y du coin supérieur gauche du raster à column et row. Les numéros de colonne et de ligne commencent à 1.

note: Tag: para
en: Returns the upper left Y coordinate of a raster column row in geometric units of the georeferenced raster. Numbering of columns and rows starts at 1 but if you pass in a negative number or number higher than number of columns/rows in raster, it will give you coordinates outside of the raster file to left or right with the assumption that the skew and pixel sizes are same as selected raster tile.
fr: Retourne la coordonnée Y du coin supérieur gauche du raster à column et row dans l'unité du système de référence spatial du raster géo-référencé. Les numéros de colonne et de ligne commencent à 1, mais si l'un des deux paramètres est 0, un nombre négatif ou supérieur à la dimension du raster, la fonction retourne des coordonnées en dehors du raster, en supposant que la grille du raster est applicable en dehors de son étendue (même taille de pixel et skew).

note: Tag: para
en: For non-skewed rasters, providing the Y column is sufficient. For skewed rasters, the georeferenced coordinate is a function of the ST_ScaleY and ST_SkewY and row and column. An error will be raised if you give just the Y row for a skewed raster.
fr: Pour des rasters sans obliquité (skew), fournir le numéro de ligne Y est suffisant. Pour des rasters avec obliquité, les coordonnées géo-référencées sont fonction de ST_ScaleY et ST_SkewY et de la ligne et colonne. Une erreur sera émise si seulement la ligne Y est fournie pour une raster avec obliquité.

note: Tag: para
en: Changed: 2.1.0 In prior versions, this was called ST_Raster2WorldCoordY
fr: Changement : 2.1.0 Jusqu'à la version 2.0.x, cette fonction était appelée ST_Raster2WorldCoordY

note: Tag: refpurpose
en: Returns the rotation of the raster in radian.
fr: Retourne l'angle de rotation du raster en radians.

note: Tag: para
en: Returns the uniform rotation of the raster in radian. If a raster does not have uniform rotation, NaN is returned. Refer to <ulink url="http://en.wikipedia.org/wiki/World_file">World File</ulink> for more details.
fr: Retourne la rotation uniforme du raster en radians. Si le raster n'a pas de rotation uniforme, retourne NaN. Voir <ulink url="https://fr.wikipedia.org/wiki/World_file">World File</ulink> pour plus de détails.

note: Tag: refpurpose
en: Returns the georeference X skew (or rotation parameter).
fr: Retourne l'obliquité géo-référencée X (paramètre de rotation).

note: Tag: para
en: Returns the georeference X skew (or rotation parameter). Refer to <ulink url="http://en.wikipedia.org/wiki/World_file">World File</ulink> for more details.
fr: Retourne l'obliquité géo-référencée X (paramètre de rotation). Voir <ulink url="https://fr.wikipedia.org/wiki/World_file">World File</ulink> pour plus de détails.

note: Tag: refpurpose
en: Returns the georeference Y skew (or rotation parameter).
fr: Retourne l'obliquité géo-référencée Y (paramètre de rotation).

note: Tag: para
en: Returns the georeference Y skew (or rotation parameter). Refer to <ulink url="http://en.wikipedia.org/wiki/World_file">World File</ulink> for more details.
fr: Retourne l'obliquité géo-référencée Y (paramètre de rotation). Voir <ulink url="https://fr.wikipedia.org/wiki/World_file">World File</ulink> pour plus de détails.

note: Tag: refpurpose
en: Returns the spatial reference identifier of the raster as defined in spatial_ref_sys table.
fr: Retourne l'identifiant du système de référence spatial du raster, tel que défini dans la table spatial_ref_sys.

note: Tag: para
en: Returns the spatial reference identifier of the raster object as defined in the spatial_ref_sys table.
fr: Retourne l'identifiant du système de référence spatial du raster, tel que défini dans la table spatial_ref_sys.

note: Tag: para
en: From PostGIS 2.0+ the srid of a non-georeferenced raster/geometry is 0 instead of the prior -1.
fr: À partir de PostGIS 2.0+, le SRID d'un raster ou d'une géométrie non-géo-référencée est 0 au lieu de -1 précédemment.

note: Tag: refpurpose
en: <refpurpose>Returns a text summary of the contents of the raster.</refpurpose>
fr: <refpurpose>Retourne un résumé du contenu du raster sous forme de texte.</refpurpose>

note: Tag: para
en: <para>Returns a text summary of the contents of the raster.</para>
fr: <para>Retourne un résumé du contenu du raster sous forme de texte.</para>

note: Tag: refpurpose
en: <refpurpose>Returns the upper left X coordinate of raster in projected spatial ref.</refpurpose>
fr: <refpurpose>Retourne la coordonnée X du coin supérieur gauche du raster projeté dans le système de référence spatial.</refpurpose>

note: Tag: para
en: <para>Returns the upper left X coordinate of raster in projected spatial ref.</para>
fr: <para>Retourne la coordonnée X du coin supérieur gauche du raster projeté dans le système de référence spatial.</para>

note: Tag: refpurpose
en: <refpurpose>Returns the upper left Y coordinate of raster in projected spatial ref.</refpurpose>
fr: <refpurpose>Retourne la coordonnée Y du coin supérieur gauche du raster projeté dans le système de référence spatial.</refpurpose>

note: Tag: para
en: <para>Returns the upper left Y coordinate of raster in projected spatial ref.</para>
fr: <para>Retourne la coordonnée Y du coin supérieur gauche du raster projeté dans le système de référence spatial.</para>

note: Tag: refpurpose
en: <refpurpose>Returns the width of the raster in pixels.</refpurpose>
fr: <refpurpose>Retourne la largeur du raster en pixels.</refpurpose>

note: Tag: para
en: <para>Returns the width of the raster in pixels.</para>
fr: <para>Retourne la largeur du raster en pixels.</para>

note: Tag: refpurpose
en: Returns the upper left corner as column and row given geometric X and Y (longitude and latitude) or a point geometry expressed in the spatial reference coordinate system of the raster.
fr: Retourne le coin supérieur gauche comme colonne et ligne, en fonction de coordonnées géométriques X et Y (longitude et latitude) ou un point géométrique dans le système de référence spatial du raster.

note: Tag: para
en: Returns the upper left corner as column and row given geometric X and Y (longitude and latitude) or a point geometry. This function works regardless of whether or not the geometric X and Y or point geometry is outside the extent of the raster. Geometric X and Y must be expressed in the spatial reference coordinate system of the raster.
fr: Retourne le coin supérieur gauche comme colonne et ligne, en fonction de coordonnées géométriques X et Y (longitude et latitude) ou un point géométrique. Cette fonction fonctionne aussi bien si X et Y ou le point sont dans l'étendue du raster ou non. Les coordonnées géométriques X et Y ou les coordonnées du point doivent être dans le système de référence spatial du raster.

note: Tag: refpurpose
en: Returns the column in the raster of the point geometry (pt) or a X and Y world coordinate (xw, yw) represented in world spatial reference system of raster.
fr: Retourne la colonne dans le raster du point géométrique (pt) ou des coordonnées X et Y (xw, yw) exprimés dans le système de référence spatial du raster.

note: Tag: para
en: Returns the column in the raster of the point geometry (pt) or a X and Y world coordinate (xw, yw). A point, or (both xw and yw world coordinates are required if a raster is skewed). If a raster is not skewed then xw is sufficient. World coordinates are in the spatial reference coordinate system of the raster.
fr: Retourne la colonne dans le raster du point géométrique (pt) ou des coordonnées X et Y (xw, yw). Un point, ou le couple (xw, yw) sont requis pour un raster avec obliquité (skew). Sinon, xw est suffisant. Les coordonnées sont exprimées dans le système de référence spatial du raster.

note: Tag: para
en: Changed: 2.1.0 In prior versions, this was called ST_World2RasterCoordX
fr: Changement : 2.1.0 Dans les versions précédentes, cette fonctionne était appelée ST_World2RasterCoordX

note: Tag: refpurpose
en: Returns the row in the raster of the point geometry (pt) or a X and Y world coordinate (xw, yw) represented in world spatial reference system of raster.
fr: Retourne la ligne dans le raster du point géométrique (pt) ou des coordonnées X et Y (xw, yw) exprimés dans le système de référence spatial du raster.

note: Tag: para
en: Returns the row in the raster of the point geometry (pt) or a X and Y world coordinate (xw, yw). A point, or (both xw and yw world coordinates are required if a raster is skewed). If a raster is not skewed then xw is sufficient. World coordinates are in the spatial reference coordinate system of the raster.
fr: Retourne la ligne dans le raster du point géométrique (pt) ou des coordonnées X et Y (xw, yw). Un point, ou le couple (xw, yw) sont requis pour un raster avec obliquité (skew). Sinon, xw est suffisant. Les coordonnées sont exprimées dans le système de référence spatial du raster.

note: Tag: para
en: Changed: 2.1.0 In prior versions, this was called ST_World2RasterCoordY
fr: Changement : 2.1.0 Dans les versions précédentes, cette fonctionne était appelée ST_World2RasterCoordY

note: Tag: title
en: Raster Band Accessors
fr: Fonctions d'accès aux bandes raster

note: Tag: refpurpose
en: Returns basic meta data for a specific raster band. band num 1 is assumed if none-specified.
fr: Retourne les méta-données de base d'une bande raster spécifique. Si aucune bande n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: Returns basic meta data about a raster band. Columns returned: pixeltype, nodatavalue, isoutdb, path, outdbbandnum, filesize, filetimestamp.
fr: Retourne les méta-données de base d'une bande raster spécifique. Les colonnes retournées sont : pixeltype, nodatavalue, isoutdb, path, outdbbandnum, filesize, filetimestamp.

note: Tag: para
en: If raster contains no bands then an error is thrown.
fr: Si le raster ne contient aucune bande, une erreur est émise.

note: Tag: para
en: If band has no NODATA value, nodatavalue are NULL.
fr: Si la bande n'a pas de valeur NODATA, nodatavalue est NULL.

note: Tag: para
en: If isoutdb is False, path, outdbbandnum, filesize and filetimestamp are NULL. If outdb access is disabled, filesize and filetimestamp will also be NULL.
fr: Si isoutdb est False, alors path, outdbbandnum, filesize et filetimestamp sont NULL. Si l'accès outdb est désactivé, filesize et filetimestamp sont également NULL.

note: Tag: para
en: Enhanced: 2.5.0 to include <emphasis>outdbbandnum</emphasis>, <emphasis>filesize</emphasis> and <emphasis>filetimestamp</emphasis> for outdb rasters.
fr: Amélioration : 2.5.0 ajout de <emphasis>outdbbandnum</emphasis>, <emphasis>filesize</emphasis> et <emphasis>filetimestamp</emphasis> pour les rasters outdb.

note: Tag: title
en: Examples: Variant 1
fr: Exemples : Variante 1

note: Tag: title
en: Examples: Variant 2
fr: Exemples : Variante 2

note: Tag: refpurpose
en: Returns the value in a given band that represents no data. If no band num 1 is assumed.
fr: Retourne la valeur qui représente l'absence de valeur (nodata) pour cette bande. Si aucune bande n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: Returns the value that represents no data for the band
fr: Retourne la valeur qui représente l'absence de valeur (nodata) pour cette bande

note: Tag: refpurpose
en: Returns true if the band is filled with only nodata values.
fr: Retourne true si la bande ne contient que des valeurs nodata.

note: Tag: para
en: Returns true if the band is filled with only nodata values. Band 1 is assumed if not specified. If the last argument is TRUE, the entire band is checked pixel by pixel. Otherwise, the function simply returns the value of the isnodata flag for the band. The default value for this parameter is FALSE, if not specified.
fr: Retourne true si la bande ne contient que des valeurs nodata. Si aucune bande n'est spécifiée, la bande 1 est utilisée. Si le dernier paramètre est TRUE, la bande entière est vérifiée pixel par pixel. Sinon, la fonction retourne simplement la valeur du flag isnodata pour cette bande. La valeur par défaut pour ce paramètre est FALSE.

note: Tag: para
en: If the flag is dirty (this is, the result is different using TRUE as last parameter and not using it) you should update the raster to set this flag to true, by using ST_SetBandIsNodata(), or ST_SetBandNodataValue() with TRUE as last argument. See <xref linkend="RT_ST_SetBandIsNoData"/>.
fr: Si le flag est obsolète (c'est à dire si le résultat est différent selon qu'on utilise TRUE ou non comme dernier paramètre), vous devriez mettre à jour le raster pour mettre à jour ce flag, en utilisant ST_SetBandIsNodata(), ou ST_SetBandNodataValue() avec TRUE en dernier paramètre. Voir <xref linkend="RT_ST_SetBandIsNoData"/>.

note: Tag: refpurpose
en: Returns system file path to a band stored in file system. If no bandnum specified, 1 is assumed.
fr: Retourne le chemin système du fichier d'une bande stockée sur le système de fichier. Si aucune bande n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: Returns system file path to a band. Throws an error if called with an in db band.
fr: Retourne le chemin système du fichier d'une bande. Renvoie une erreur si la bande n'est pas outofdb.

note: Tag: refpurpose
en: Returns the file size of a band stored in file system. If no bandnum specified, 1 is assumed.
fr: Retourne la taille du fichier d'une bande stockée sur le système de fichier. Si aucune bande n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: Returns the file size of a band stored in file system. Throws an error if called with an in db band, or if outdb access is not enabled.
fr: Retourne la taille du fichier d'une bande stockée sur le système de fichier. Renvoie une erreur si la bande n'est pas outofdb, ou si l'accès outdb est désactivé.

note: Tag: para
en: This function is typically used in conjunction with ST_BandPath() and ST_BandFileTimestamp() so a client can determine if the filename of a outdb raster as seen by it is the same as the one seen by the server.
fr: Cette fonction est généralement utilisée conjointement à ST_BandPath() et ST_BandFileTimestamp(), pour qu'un client puisse déterminer le nom du fichier d'un raster outdb, tel que vu par le serveur.

note: Tag: para
en: Availability: 2.5.0
fr: Disponibilité : 2.5.0

note: Tag: refpurpose
en: Returns the file timestamp of a band stored in file system. If no bandnum specified, 1 is assumed.
fr: Retourne le timestamp du fichier d'une bande stockée sur le système de fichier. Si aucune bande n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: Returns the file timestamp (number of seconds since Jan 1st 1970 00:00:00 UTC) of a band stored in file system. Throws an error if called with an in db band, or if outdb access is not enabled.
fr: Retourne le timestamp (nombre de secondes depuis Jan 1st 1970 00:00:00 UTC) du fichier d'une bande stockée sur le système de fichier. Renvoie une erreur si la bande n'est pas outofdb, ou si l'accès outdb est désactivé.

note: Tag: para
en: This function is typically used in conjunction with ST_BandPath() and ST_BandFileSize() so a client can determine if the filename of a outdb raster as seen by it is the same as the one seen by the server.
fr: Cette fonction est généralement utilisée conjointement à ST_BandPath() et ST_BandFileSize(), pour qu'un client puisse déterminer le nom du fichier d'un raster outdb, tel que vu par le serveur.

note: Tag: refpurpose
en: Returns the type of pixel for given band. If no bandnum specified, 1 is assumed.
fr: Retourne le type de pixel d'une bande. Si aucune bande n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: Returns name describing data type and size of values stored in each cell of given band.
fr: Retourne le nom décrivant le type de données et la taille des valeurs stockées pour chaque pixel de la bande spécifiée.

note: Tag: para
en: There are 11 pixel types. Pixel Types supported are as follows:
fr: Il existe 11 types de pixels. Les types de pixels supportés sont :

note: Tag: para
en: 1BB - 1-bit boolean
fr: 1BB - booléen 1-bit

note: Tag: para
en: 2BUI - 2-bit unsigned integer
fr: 2BUI - entier non signé 2-bits

note: Tag: para
en: 4BUI - 4-bit unsigned integer
fr: 4BUI - entier non signé 4-bits

note: Tag: para
en: 8BSI - 8-bit signed integer
fr: 8BSI - entier signé 8-bits

note: Tag: para
en: 8BUI - 8-bit unsigned integer
fr: 8BUI - entier non signé 8-bits

note: Tag: para
en: 16BSI - 16-bit signed integer
fr: 16BSI - entier signé 16-bits

note: Tag: para
en: 16BUI - 16-bit unsigned integer
fr: 16BUI - entier non signé 16-bits

note: Tag: para
en: 32BSI - 32-bit signed integer
fr: 32BSI - entier signé 32-bits

note: Tag: para
en: 32BUI - 32-bit unsigned integer
fr: 32BUI - entier non signé 32-bits

note: Tag: para
en: 32BF - 32-bit float
fr: 32BF - flottant 32-bits

note: Tag: para
en: 64BF - 64-bit float
fr: 64BF - flottant 64-bits

note: Tag: refpurpose
en: <refpurpose>Returns the minimum value this pixeltype can store.</refpurpose>
fr: <refpurpose>Retourne la valeur minimale supportée par le type de pixel pixeltype.</refpurpose>

note: Tag: para
en: <para>Returns the minimum value this pixeltype can store.</para>
fr: <para>Retourne la valeur minimale supportée par le type de pixel pixeltype.</para>

note: Tag: refpurpose
en: <refpurpose>Returns true if there is no band with given band number. If no band number is specified, then band number 1 is assumed.</refpurpose>
fr: <refpurpose>Retourne true si le raster n'a pas la bande spécifiée. Si aucune bande n'est spécifiée, la bande 1 est utilisée.</refpurpose>

note: Tag: para
en: <para>Returns true if there is no band with given band number. If no band number is specified, then band number 1 is assumed.</para>
fr: <para>Retourne true si le raster n'a pas la bande spécifiée. Si aucune bande n'est spécifiée, la bande 1 est utilisée.</para>

note: Tag: title
en: Raster Pixel Accessors and Setters
fr: Fonctions d'accès et de modifications des pixels raster

note: Tag: refpurpose
en: <refpurpose>Returns the polygon geometry that bounds the pixel for a particular row and column.</refpurpose>
fr: <refpurpose>Retourne la géométrie polygonale qui délimite le pixel pour une ligne et colonne spécifiées.</refpurpose>

note: Tag: para
en: <para>Returns the polygon geometry that bounds the pixel for a particular row and column.</para>
fr: <para>Retourne la géométrie polygonale qui délimite le pixel pour une ligne et colonne spécifiées.</para>

note: Tag: refpurpose
en: Returns the polygon geometry that bounds every pixel of a raster band along with the value, the X and the Y raster coordinates of each pixel.
fr: Retourne la géométrie polygonale qui délimite chaque pixel de la bande raster, avec la valeur et les coordonnées raster X et Y de chaque pixel.

note: Tag: para
en: Returns the polygon geometry that bounds every pixel of a raster band along with the value (double precision), the X and the Y raster coordinates (integers) of each pixel.
fr: Retourne la géométrie polygonale qui délimite chaque pixel de la bande raster, avec la valeur (double précision) et les coordonnées raster X et Y (entiers) de chaque pixel.

note: Tag: para
en: Return record format: <parameter>geom</parameter> <xref linkend="geometry"/>, <parameter>val</parameter> double precision, <parameter>x</parameter> integer, <parameter>y</parameter> integers.
fr: Format de l'enregistrement de retour : <parameter>geom</parameter> <xref linkend="geometry"/>, <parameter>val</parameter> double precision, <parameter>x</parameter> entier, <parameter>y</parameter> entier.

note: Tag: para
en: When <parameter>exclude_nodata_value</parameter> = TRUE, only those pixels whose values are not NODATA are returned as points.
fr: Si <parameter>exclude_nodata_value</parameter> = TRUE, seuls les pixels qui ne sont pas NODATA sont retournés.

note: Tag: para
en: ST_PixelAsPolygons returns one polygon geometry for every pixel. This is different than ST_DumpAsPolygons where each geometry represents one or more pixels with the same pixel value.
fr: ST_PixelAsPolygons retourne un polygone pour chaque pixel. Ce comportement est différent de ST_DumpAsPolygons, où chaque géométrie représente un ou plusieurs pixels de même valeur.

note: Tag: para
en: Enhanced: 2.1.0 exclude_nodata_value optional argument was added.
fr: Amélioration : 2.1.0 ajout du paramètre optionnel exclude_nodata_value.

note: Tag: para
en: Changed: 2.1.1 Changed behavior of exclude_nodata_value.
fr: Changement : 2.1.1 Changement du comportement de behavior of exclude_nodata_value.

note: Tag: refpurpose
en: <refpurpose>Returns a point geometry of the pixel's upper-left corner.</refpurpose>
fr: <refpurpose>Retourne le point géométrique du coin supérieur gauche du pixel.</refpurpose>

note: Tag: para
en: <para>Returns a point geometry of the pixel's upper-left corner.</para>
fr: <para>Retourne le point géométrique du coin supérieur gauche du pixel.</para>

note: Tag: refpurpose
en: <refpurpose>Returns a point geometry for each pixel of a raster band along with the value, the X and the Y raster coordinates of each pixel. The coordinates of the point geometry are of the pixel's upper-left corner.</refpurpose>
fr: <refpurpose>Retourne un point géométrique pour chaque pixel de la bande raster, avec sa valeur et ses coordonnées raster X et Y. Les coordonnées du points sont ceux du coin supérieur gauche du pixel.</refpurpose>

note: Tag: para
en: <para>Returns a point geometry for each pixel of a raster band along with the value, the X and the Y raster coordinates of each pixel. The coordinates of the point geometry are of the pixel's upper-left corner.</para>
fr: <para>Retourne un point géométrique pour chaque pixel de la bande raster, avec sa valeur et ses coordonnées raster X et Y. Les coordonnées du points sont ceux du coin supérieur gauche du pixel.</para>

note: Tag: refpurpose
en: <refpurpose>Returns the centroid (point geometry) of the area represented by a pixel.</refpurpose>
fr: <refpurpose>Retourne le centroïde (point géométrique) de la zone représentée par un pixel.</refpurpose>

note: Tag: para
en: <para>Returns the centroid (point geometry) of the area represented by a pixel.</para>
fr: <para>Retourne le centroïde (point géométrique) de la zone représentée par un pixel.</para>

note: Tag: para
en: Enhanced: 3.2.0 Faster now implemented in C.
fr: Amélioration : 3.2.0 Plus rapide, désormais implémenté en C.

note: Tag: refpurpose
en: <refpurpose>Returns the centroid (point geometry) for each pixel of a raster band along with the value, the X and the Y raster coordinates of each pixel. The point geometry is the centroid of the area represented by a pixel.</refpurpose>
fr: <refpurpose>Retourne le centroïde (point géométrique) pour chaque pixel de la bande raster, avec sa valeur et les coordonnées raster X et Y. Le point géométrique est le centroïde de la zone représentée par un pixel.</refpurpose>

note: Tag: para
en: <para>Returns the centroid (point geometry) for each pixel of a raster band along with the value, the X and the Y raster coordinates of each pixel. The point geometry is the centroid of the area represented by a pixel.</para>
fr: <para>Retourne le centroïde (point géométrique) pour chaque pixel de la bande raster, avec sa valeur et les coordonnées raster X et Y. Le point géométrique est le centroïde de la zone représentée par un pixel.</para>

note: Tag: refpurpose
en: Returns the value of a given band in a given columnx, rowy pixel or at a particular geometric point. Band numbers start at 1 and assumed to be 1 if not specified. If <varname>exclude_nodata_value</varname> is set to false, then all pixels include <varname>nodata</varname> pixels are considered to intersect and return value. If <varname>exclude_nodata_value</varname> is not passed in then reads it from metadata of raster.
fr: Retourne la valeur d'une bande raster spécifiée au pixel donné par columnx, rowy, ou à un point géométrique spécifié. Le numéro de bande démarre à 1, et la bande 1 est utilisée si non spécifié. Si <varname>exclude_nodata_value</varname> vaut false, tous les pixels y compris ceux ayant la valeur <varname>nodata</varname> sont considérés comme intersectés et leur valeur sera retournée. Si <varname>exclude_nodata_value</varname> n'est pas spécifié, la valeur est lue depuis les méta-données du raster.

note: Tag: para
en: Returns the value of a given band in a given columnx, rowy pixel or at a given geometry point. Band numbers start at 1 and band is assumed to be 1 if not specified.
fr: Retourne la valeur d'une bande raster spécifiée au pixel donné par columnx, rowy, ou à un point géométrique spécifié. Le numéro de bande démarre à 1, et la bande 1 est utilisée si non spécifié.

note: Tag: para
en: If <varname>exclude_nodata_value</varname> is set to true, then only non <varname>nodata</varname> pixels are considered. If <varname>exclude_nodata_value</varname> is set to false, then all pixels are considered.
fr: Si <varname>exclude_nodata_value</varname> vaut true, seulement les pixels différents de la valeur <varname>nodata</varname> seront utilisés. Si <varname>exclude_nodata_value</varname> vaut false, tous les pixels seront utilisés.

note: Tag: para
en: The allowed values of the <varname>resample</varname> parameter are "nearest" which performs the default nearest-neighbor resampling, and "bilinear" which performs a <ulink url="https://en.wikipedia.org/wiki/Bilinear_interpolation">bilinear interpolation</ulink> to estimate the value between pixel centers.
fr: Les valeurs possibles pour le paramètre <varname>resample</varname> sont : "nearest" (interpolation par plus proche voisin) et "bilinear" (<ulink url="https://fr.wikipedia.org/wiki/Interpolation_bilin%C3%A9aire">interpolation bilinéaire</ulink>). Ce paramètre est utilisé pour estimer la valeur entre les centres des pixels.

note: Tag: para
en: Enhanced: 3.2.0 resample optional argument was added.
fr: Amélioration : 3.2.0 ajout du paramètre optionnel resample.

note: Tag: para
en: Enhanced: 2.0.0 exclude_nodata_value optional argument was added.
fr: Amélioration : 2.0.0 ajout du paramètre optionnel exclude_nodata_value.

note: Tag: refpurpose
en: Returns the nearest non-<varname>NODATA</varname> value of a given band's pixel specified by a columnx and rowy or a geometric point expressed in the same spatial reference coordinate system as the raster.
fr: Retourne la valeur la plus proche différent de <varname>NODATA</varname> pour une bande raster spécifiée au pixel donné par columnx et rowy, ou à un point géométrique spécifié dans le même système de référence spatial que le raster.

note: Tag: para
en: Returns the nearest non-<varname>NODATA</varname> value of a given band in a given columnx, rowy pixel or at a specific geometric point. If the columnx, rowy pixel or the pixel at the specified geometric point is <varname>NODATA</varname>, the function will find the nearest pixel to the columnx, rowy pixel or geometric point whose value is not <varname>NODATA</varname>.
fr: Retourne la valeur la plus proche différent de <varname>NODATA</varname> pour une bande raster spécifiée au pixel donné par columnx et rowy, ou à un point géométrique spécifié. Si le pixel donné par columnx, rowy ou par le point géométrique est de valeur <varname>NODATA</varname>, la fonction trouve le plus proche pixel dont la valeur est différente de <varname>NODATA</varname>.

note: Tag: para
en: Band numbers start at 1 and <varname>bandnum</varname> is assumed to be 1 if not specified. If <varname>exclude_nodata_value</varname> is set to false, then all pixels include <varname>nodata</varname> pixels are considered to intersect and return value. If <varname>exclude_nodata_value</varname> is not passed in then reads it from metadata of raster.
fr: Le numéro de bande démarre à 1, et la bande 1 est utilisée si <varname>bandnum</varname> non spécifié. Si <varname>exclude_nodata_value</varname> vaut false, tous les pixels y compris ceux ayant la valeur <varname>nodata</varname> sont considérés comme intersectés et leur valeur sera retournée. Si <varname>exclude_nodata_value</varname> n'est pas spécifié, la valeur est lue depuis les méta-données du raster.

note: Tag: para
en: ST_NearestValue is a drop-in replacement for ST_Value.
fr: ST_NearestValue remplace directement ST_Value.

note: Tag: refpurpose
en: Returns a geometry with the same X/Y coordinates as the input geometry, and values from the raster copied into the Z dimension using the requested resample algorithm.
fr: Retourne une géométrie avec les mêmes coordonnées X/Y que la géométrie d'entrée, et avec la coordonnée Z copiée depuis les valeurs du raster selon l'algorithme d'interpolation en paramètre.

note: Tag: para
en: Returns a geometry with the same X/Y coordinates as the input geometry, and values from the raster copied into the Z dimensions using the requested resample algorithm.
fr: Retourne une géométrie avec les mêmes coordonnées X/Y que la géométrie d'entrée, et avec la coordonnée Z copiée depuis les valeurs du raster selon l'algorithme d'interpolation en paramètre.

note: Tag: para
en: The <varname>resample</varname> parameter can be set to "nearest" to copy the values from the cell each vertex falls within, or "bilinear" to use <ulink url="https://en.wikipedia.org/wiki/Bilinear_interpolation">bilinear interpolation</ulink> to calculate a value that takes neighboring cells into account also.
fr: Le paramètre <varname>resample</varname> peut être "nearest" (plus proche) pour copier les valeurs de chaque pixel auquel le vertex correspond, ou "bilinear" pour utiliser une <ulink url="https://fr.wikipedia.org/wiki/Interpolation_bilin%C3%A9aire">interpolation bilinéaire</ulink> pour calculer une valeur qui prend aussi en compte les pixels voisins.

note: Tag: refpurpose
en: Returns a geometry with the same X/Y coordinates as the input geometry, and values from the raster copied into the M dimension using the requested resample algorithm.
fr: Retourne une géométrie avec les mêmes coordonnées X/Y que la géométrie d'entrée, et avec la coordonnée M copiée depuis les valeurs du raster selon l'algorithme d'interpolation en paramètre.

note: Tag: para
en: Returns a geometry with the same X/Y coordinates as the input geometry, and values from the raster copied into the M dimensions using the requested resample algorithm.
fr: Retourne une géométrie avec les mêmes coordonnées X/Y que la géométrie d'entrée, et avec la coordonnée M copiée depuis les valeurs du raster selon l'algorithme d'interpolation en paramètre.

note: Tag: refpurpose
en: Returns a 2-D double precision array of the non-<varname>NODATA</varname> values around a given band's pixel specified by either a columnX and rowY or a geometric point expressed in the same spatial reference coordinate system as the raster.
fr: Retourne un tableau 2-D de double avec les valeurs non <varname>NODATA</varname> autour du pixel de la bande spécifiée, aux coordonnées spécifiées par columnX &amp; rowY ou par un point géométrique dans le même système de référence spatial que le raster.

note: Tag: para
en: Returns a 2-D double precision array of the non-<varname>NODATA</varname> values around a given band's pixel specified by either a columnX and rowY or a geometric point expressed in the same spatial reference coordinate system as the raster. The <varname>distanceX</varname> and <varname>distanceY</varname> parameters define the number of pixels around the specified pixel in the X and Y axes, e.g. I want all values within 3 pixel distance along the X axis and 2 pixel distance along the Y axis around my pixel of interest. The center value of the 2-D array will be the value at the pixel specified by the columnX and rowY or the geometric point.
fr: Retourne un tableau 2-D de double avec les valeurs non <varname>NODATA</varname> autour du pixel de la bande spécifiée, aux coordonnées spécifiées par columnX &amp; rowY ou par un point géométrique dans le même système de référence spatial que le raster. Les paramètres <varname>distanceX</varname> et <varname>distanceY</varname> définissent le nombre de pixels autour du pixel spécifié sur les axes X et Y. Exemple : vous pouvez récupérer toutes les valeurs autour du pixel souhaité, à une distance de 3 pixels selon l'axe X et à une distance de 2 pixels selon l'axe Y. La valeur centrale du tableau 2-D sera la valeur du pixel spécifié par columnX et rowY ou par le point géométrique.

note: Tag: para
en: The number of elements along each axis of the returning 2-D array is 2 * (<varname>distanceX</varname>|<varname>distanceY</varname>) + 1. So for a <varname>distanceX</varname> and <varname>distanceY</varname> of 1, the returning array will be 3x3.
fr: Le nombre d'éléments retournés dans le tableau 2-D sur chaque axe sera 2 * (<varname>distanceX</varname>|<varname>distanceY</varname>) + 1. Pour <varname>distanceX</varname> et <varname>distanceY</varname> de 1, le tableau sera de taille 3x3.

note: Tag: para
en: The 2-D array output can be passed to any of the raster processing builtin functions, e.g. ST_Min4ma, ST_Sum4ma, ST_Mean4ma.
fr: Le tableau 2-D en sortie peut être passé à n'importe quelle fonction de traitement raster, comme ST_Min4ma, ST_Sum4ma, ST_Mean4ma.

note: Tag: refpurpose
en: Returns modified raster resulting from setting the value of a given band in a given columnx, rowy pixel or the pixels that intersect a particular geometry. Band numbers start at 1 and assumed to be 1 if not specified.
fr: Retourne un nouveau raster en modifiant la valeur du pixel pour la bande spécifiée et aux coordonnées columnx, rowy, ou pour tous les pixels qui intersectent une géométrie spécifiée. Le numéro de bande démarre à 1, et la bande 1 est utilisée si non spécifié.

note: Tag: para
en: Returns modified raster resulting from setting the specified pixels' values to new value for the designated band given the raster's row and column or a geometry. If no band is specified, then band 1 is assumed.
fr: Retourne un nouveau raster en modifiant la valeur du pixel pour la bande spécifiée et aux coordonnées columnx, rowy, ou pour tous les pixels qui intersectent une géométrie spécifiée. Le numéro de bande démarre à 1, et la bande 1 est utilisée si non spécifié.

note: Tag: para
en: Enhanced: 2.1.0 Geometry variant of ST_SetValue() now supports any geometry type, not just point. The geometry variant is a wrapper around the geomval[] variant of ST_SetValues()
fr: Amélioration : 2.1.0 La variante de ST_SetValue() avec la géométrie supporte n'importe quelle type de géométrie, pas uniquement des points. La variante avec la géométrie est une enveloppe autour de la variante de ST_SetValues() avec geomval[]

note: Tag: refpurpose
en: Returns modified raster resulting from setting the values of a given band.
fr: Retourne un nouveau raster en modifiant les valeurs de certains pixels d'une bande spécifiée.

note: Tag: para
en: Returns modified raster resulting from setting specified pixels to new value(s) for the designated band. <varname>columnx</varname> and <varname>rowy</varname> are 1-indexed.
fr: Retourne un nouveau raster en modifiant les valeurs de certains pixels d'une bande spécifiée. Les paramètres <varname>columnx</varname> et <varname>rowy</varname> démarrent à 1.

note: Tag: para
en: If <varname>keepnodata</varname> is TRUE, those pixels whose values are NODATA will not be set with the corresponding value in <varname>newvalueset</varname>.
fr: Si <varname>keepnodata</varname> est TRUE, les pixels qui sont NODATA ne seront pas mis à jour avec la valeur donnée par <varname>newvalueset</varname>.

note: Tag: para
en: For Variant 1, the specific pixels to be set are determined by the <varname>columnx</varname>, <varname>rowy</varname> pixel coordinates and the dimensions of the <varname>newvalueset</varname> array. <varname>noset</varname> can be used to prevent pixels with values present in <varname>newvalueset</varname> from being set (due to PostgreSQL not permitting ragged/jagged arrays). See example Variant 1.
fr: Pour la variante 1, les pixels sont déterminés par les coordonnées du pixel <varname>columnx</varname> et <varname>rowy</varname>, ainsi que la dimension du tableau <varname>newvalueset</varname>. <varname>noset</varname> peut être utilisé pour s'assurer qu'aucun pixel présent dans <varname>newvalueset</varname> et ayant déjà une valeur soient modifiés (PostgreSQL ne supportant pas les tableaux irréguliers/agglomérés). Voir l'exemple Variante 1.

note: Tag: para
en: Variant 2 is like Variant 1 but with a simple double precision <varname>nosetvalue</varname> instead of a boolean <varname>noset</varname> array. Elements in <varname>newvalueset</varname> with the <varname>nosetvalue</varname> value with be skipped. See example Variant 2.
fr: La variante 2 est similaire à la variante 1, mais avec une valeur unique en double precision <varname>nosetvalue</varname> au lieu du tableau de booléens <varname>noset</varname>. Les éléments dans <varname>newvalueset</varname> avec la valeur <varname>nosetvalue</varname> seront ignorés. Voir l'exemple Variante 2.

note: Tag: para
en: For Variant 3, the specific pixels to be set are determined by the <varname>columnx</varname>, <varname>rowy</varname> pixel coordinates, <varname>width</varname> and <varname>height</varname>. See example Variant 3.
fr: Pour la variante 3, les pixels à modifier doivent être explicitement spécifiés par les coordonnées <varname>columnx</varname>, <varname>rowy</varname>, ainsi que les tailles <varname>width</varname> (largeur) et <varname>height</varname> (hauteur). Voir l'exemple Variante 3.

note: Tag: para
en: Variant 4 is the same as Variant 3 with the exception that it assumes that the first band's pixels of <varname>rast</varname> will be set.
fr: La variante 4 est identique à la variante 3, en modifiant la bande raster 1 du raster <varname>rast</varname>.

note: Tag: para
en: For Variant 5, an array of <xref linkend="geomval"/> is used to determine the specific pixels to be set. If all the geometries in the array are of type POINT or MULTIPOINT, the function uses a shortcut where the longitude and latitude of each point is used to set a pixel directly. Otherwise, the geometries are converted to rasters and then iterated through in one pass. See example Variant 5.
fr: Pour la variante 5, un tableau de <xref linkend="geomval"/> est utilisé pour déterminer les pixels à modifier. Si toutes les géométries du tableau sont de type POINT ou MULTIPOINT, la fonction utilise un raccourci où la longitude et la latitude du chaque point sont utilisés pour modifier directement le pixel. Sinon, les géométries sont converties en raster, puis itérés en une passe. Voir l'exemple Variante 5.

note: Tag: title
en: Examples: Variant 3
fr: Exemples : Variante 3

note: Tag: title
en: Examples: Variant 5
fr: Exemples : Variante 5

note: Tag: para
en: The following shows that geomvals later in the array can overwrite prior geomvals
fr: L'exemple suivant montre qu'une géométrie située plus loin dans le tableau peut écraser une valeur issue d'une géométrie précédente

note: Tag: para
en: This example is the opposite of the prior example
fr: Cet exemple est le contraire de l'exemple précédent

note: Tag: refpurpose
en: Get the values of the specified band as a 2-dimension array.
fr: Retourne les valeurs d'une bande raster spécifiée, sous forme d'un tableau à deux dimensions.

note: Tag: para
en: Get the values of the specified band as a 2-dimension array (first index is row, second is column). If <varname>nband</varname> is NULL or not provided, all raster bands are processed.
fr: Retour les valeurs d'une bande, sous forme d'un tableau à 2 dimensions (le premier index étant la ligne, le second étant la colonne). Si <varname>nband</varname> est NULL ou non spécifié, toutes les bandes raster sont traitées.

note: Tag: refpurpose
en: Get the columnx, rowy coordinates of the pixel whose value equals the search value.
fr: Retourne les coordonnées columnx, rowy du pixel dont la valeur est égale à la valeur recherchée.

note: Tag: para
en: Get the columnx, rowy coordinates of the pixel whose value equals the search value. If no band is specified, then band 1 is assumed.
fr: Retourne les coordonnées columnx, rowy du pixel dont la valeur est égale à la valeur recherchée. Si aucune bande n'est spécifiée, la bande 1 est utilisée.

note: Tag: title
en: Raster Editors
fr: Éditeurs de raster

note: Tag: refpurpose
en: Set Georeference 6 georeference parameters in a single call. Numbers should be separated by white space. Accepts inputs in GDAL or ESRI format. Default is GDAL.
fr: Définit les 6 paramètres de géo-référencement en un seul appel. Les nombres doivent être séparés par un espace. Accepte les formats GDAL (par défaut) ou ESRI.

note: Tag: para
en: Set Georeference 6 georeference parameters in a single call. Accepts inputs in 'GDAL' or 'ESRI' format. Default is GDAL. If 6 coordinates are not provided will return null.
fr: Définit les 6 paramètres de géo-référencement en un seul appel. Accepte les formats 'GDAL' (par défaut) ou 'ESRI'. Si les 6 coordonnées ne sont pas spécifiées, retourne null.

note: Tag: para
en: If the raster has out-db bands, changing the georeference may result in incorrect access of the band's externally stored data.
fr: Si le raster a des bandes out-db, modifier le géoréférencement peut entraîner un accès incorrect aux données de la bande out-db.

note: Tag: para
en: Enhanced: 2.1.0 Addition of ST_SetGeoReference(raster, double precision, ...) variant
fr: Amélioration : 2.1.0 Ajout de la variante ST_SetGeoReference(raster, double precision, ...)

note: Tag: refpurpose
en: Set the rotation of the raster in radian.
fr: Définit la rotation du raster en radians.

note: Tag: para
en: Uniformly rotate the raster. Rotation is in radian. Refer to <ulink url="http://en.wikipedia.org/wiki/World_file">World File</ulink> for more details.
fr: Applique une rotation uniforme du raster. L'angle de rotation est en radians. Voir <ulink url="https://fr.wikipedia.org/wiki/World_file">World File</ulink> pour plus de détails.

note: Tag: refpurpose
en: Sets the X and Y size of pixels in units of coordinate reference system. Number units/pixel width/height.
fr: Définit la résolution des pixels en X et Y en unité du système de référence spatial : nombre d'unités/pixel en largeur/hauteur.

note: Tag: para
en: Sets the X and Y size of pixels in units of coordinate reference system. Number units/pixel width/height. If only one unit passed in, assumed X and Y are the same number.
fr: Définit la résolution des pixels en X et Y en unité du système de référence spatial : nombre d'unités/pixel en largeur/hauteur. Si une seule unité est spécifiée, la même résolution est utilisée pour X et pour Y.

note: Tag: para
en: ST_SetScale is different from <xref linkend="RT_ST_Rescale"/> in that ST_SetScale do not resample the raster to match the raster extent. It only changes the metadata (or georeference) of the raster to correct an originally mis-specified scaling. ST_Rescale results in a raster having different width and height computed to fit the geographic extent of the input raster. ST_SetScale do not modify the width, nor the height of the raster.
fr: ST_SetScale est différent de <xref linkend="RT_ST_Rescale"/> : ST_SetScale ne rééchantillonne pas le raster pour correspondre à l'étendue du raster. La fonction modifie seulement les méta-données (ou la géo-référence) d'un raster pour corriger une échelle incorrecte. ST_Rescale produit un raster de taille différente pour correspondre à l'étendue spatiale du raster d'entrée. ST_SetScale ne modifie pas la largeur ou hauteur du raster.

note: Tag: para
en: Changed: 2.0.0 In WKTRaster versions this was called ST_SetPixelSize. This was changed in 2.0.0.
fr: Changement : 2.0.0 Dans les versions WKTRaster, cette fonction était appelée ST_SetPixelSize.

note: Tag: refpurpose
en: Sets the georeference X and Y skew (or rotation parameter). If only one is passed in, sets X and Y to the same value.
fr: Définit l'obliquité X et Y (skew, ou paramètre de rotation). Si une seule valeur est spécifiée, la même valeur est utilisée pour X et pour Y.

note: Tag: para
en: Sets the georeference X and Y skew (or rotation parameter). If only one is passed in, sets X and Y to the same value. Refer to <ulink url="http://en.wikipedia.org/wiki/World_file">World File</ulink> for more details.
fr: Définit l'obliquité X et Y (skew, ou paramètre de rotation). Si une seule valeur est spécifiée, la même valeur est utilisée pour X et pour Y. Voir <ulink url="https://fr.wikipedia.org/wiki/World_file">World File</ulink> pour plus de détails.

note: Tag: refpurpose
en: Sets the SRID of a raster to a particular integer srid defined in the spatial_ref_sys table.
fr: Modifie le SRID d'un raster à une valeur définie dans la table spatial_ref_sys.

note: Tag: para
en: Sets the SRID on a raster to a particular integer value.
fr: Modifie le SRID d'un raster à une valeur spécifiée.

note: Tag: para
en: This function does not transform the raster in any way - it simply sets meta data defining the spatial ref of the coordinate reference system that it's currently in. Useful for transformations later.
fr: Cette fonction ne modifie pas le raster en lui-même : elle définit juste la méta-données définissant le système de référence spatial. Ceci est utile pour ensuite effectuer des transformations.

note: Tag: refpurpose
en: Sets the value of the upper left corner of the pixel of the raster to projected X and Y coordinates.
fr: Modifie les coordonnées du pixel du coin supérieur gauche du raster, selon les coordonnées X et Y projetées.

note: Tag: para
en: Set the value of the upper left corner of raster to the projected X and Y coordinates
fr: Modifie les coordonnées du pixel du coin supérieur gauche du raster aux coordonnées X et Y projetées

note: Tag: refpurpose
en: Resample a raster using a specified resampling algorithm, new dimensions, an arbitrary grid corner and a set of raster georeferencing attributes defined or borrowed from another raster.
fr: Rééchantillonne un raster, en utilisant l'algorithme spécifié, les nouvelles dimensions, un coin arbitraire de la grille et un ensemble de paramètres de géo-référencement définis ou empruntés à un autre raster.

note: Tag: para
en: Resample a raster using a specified resampling algorithm, new dimensions (width &amp; height), a grid corner (gridx &amp; gridy) and a set of raster georeferencing attributes (scalex, scaley, skewx &amp; skewy) defined or borrowed from another raster. If using a reference raster, the two rasters must have the same SRID.
fr: Rééchantillonne un raster, en utilisant l'algorithme spécifié, les nouvelles dimensions (width &amp; height), un coin de la grille (gridx &amp; gridy) et un ensemble de paramètres de géo-référencement (scalex, scaley, skewx &amp; skewy) définis ou empruntés à un autre raster. Si un raster de référence est spécifié, les deux rasters doivent avoir le même SRID.

note: Tag: para
en: New pixel values are computed using one of the following resampling algorithms:
fr: Les nouvelles valeurs des pixels sont calculées par un des algorithmes de rééchantillonnage suivants :

note: Tag: para
en: NearestNeighbor (english or american spelling)
fr: NearestNeighbor (plus proche voisin)

note: Tag: para
en: Bilinear
fr: Bilinear (Bilinéaire)

note: Tag: para
en: Cubic
fr: Cubic (Cubique)

note: Tag: para
en: CubicSpline
fr: CubicSpline (Cubique Spline)

note: Tag: para
en: The default is NearestNeighbor which is the fastest but results in the worst interpolation.
fr: L'algorithme par défaut est NearestNeighbor, qui est le plus rapide mais donne le moins bon résultat.

note: Tag: para
en: A maxerror percent of 0.125 is used if no <varname>maxerr</varname> is specified.
fr: Une erreur maximale de 0.125 est utilisée si le paramètre <varname>maxerr</varname> n'est pas spécifié.

note: Tag: para
en: Refer to: <ulink url="http://www.gdal.org/gdalwarp.html">GDAL Warp resampling methods</ulink> for more details.
fr: Voir <ulink url="http://www.gdal.org/gdalwarp.html">GDAL Warp resampling methods</ulink> pour plus de détails.

note: Tag: para
en: Availability: 2.0.0 Requires GDAL 1.6.1+
fr: Disponibilité : 2.0.0 Nécessite GDAL 1.6.1+

note: Tag: para
en: Enhanced: 3.4.0 max and min resampling options added
fr: Améliration : 3.4.0 ajout des options de rééchantillonnage max et min

note: Tag: refpurpose
en: Resample a raster by adjusting only its scale (or pixel size). New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline, Lanczos, Max or Min resampling algorithm. Default is NearestNeighbor.
fr: Rééchantillonne un raster en ajustant juste son échelle (ou la taille des pixels). Les nouvelles valeurs des pixels sont calculées en utilisant l'algorithme de rééchantillonnage NearestNeighbor (plus proche voisin), Bilinear (Bilinéaire), Cubic (Cubique), CubicSpline (Cubique Spline), Lanczos, Max ou Min. La valeur par défaut est NearestNeighbor.

note: Tag: para
en: Resample a raster by adjusting only its scale (or pixel size). New pixel values are computed using one of the following resampling algorithms:
fr: Rééchantillonne un raster en ajustant juste son échelle (ou la taille des pixels). Les nouvelles valeurs des pixels sont calculées en utilisant un des algorithmes de rééchantillonnage suivants :

note: Tag: para
en: <varname>scalex</varname> and <varname>scaley</varname> define the new pixel size. scaley must often be negative to get well oriented raster.
fr: <varname>scalex</varname> et <varname>scaley</varname> définissent la nouvelle taille des pixels. scaley est souvent négatif pour obtenir un raster correctement orienté.

note: Tag: para
en: When the new scalex or scaley is not a divisor of the raster width or height, the extent of the resulting raster is expanded to encompass the extent of the provided raster. If you want to be sure to retain exact input extent see <xref linkend="RT_ST_Resize"/>
fr: Quand la nouvelle valeur de scalex (respectivement scaley) n'est pas un diviseur de la hauteur (respectivement largeur) du raster, l'étendue du raster résultant est agrandie pour englober l'étendue du raster d'entrée. Si vous voulez conserver l'étendue exacte du raster d'entrée, utilisez <xref linkend="RT_ST_Resize"/>

note: Tag: para
en: <varname>maxerr</varname> is the threshold for transformation approximation by the resampling algorithm (in pixel units). A default of 0.125 is used if no <varname>maxerr</varname> is specified, which is the same value used in GDAL gdalwarp utility. If set to zero, no approximation takes place.
fr: <varname>maxerr</varname> est le seuil pour l'approximation de l'algorithme de rééchantillonnage (en pixels). La valeur de 0.125 est utilisée si le paramètre <varname>maxerr</varname> n'est pas spécifié, qui est la même valeur que celle utilisée par l'utilitaire GDAL gdalwarp. Si définie à 0, aucune approximation n'est effectuée.

note: Tag: para
en: ST_Rescale is different from <xref linkend="RT_ST_SetScale"/> in that ST_SetScale do not resample the raster to match the raster extent. ST_SetScale only changes the metadata (or georeference) of the raster to correct an originally mis-specified scaling. ST_Rescale results in a raster having different width and height computed to fit the geographic extent of the input raster. ST_SetScale do not modify the width, nor the height of the raster.
fr: ST_Rescale est différent de <xref linkend="RT_ST_SetScale"/> : ST_SetScale ne rééchantillonne pas le raster pour correspondre à l'étendue du raster. ST_SetScale modifie seulement les méta-données (ou lagéo-référence) d'un raster pour corriger une échelle incorrecte. ST_Rescale produit un raster de taille différente pour correspondre à l'étendue spatiale du raster d'entrée. ST_SetScale ne modifie pas la largeur ou hauteur du raster.

note: Tag: para
en: Changed: 2.1.0 Works on rasters with no SRID
fr: Changement : 2.1.0 Fonctionne avec les rasters sans SRID

note: Tag: para
en: A simple example rescaling a raster from a pixel size of 0.001 degree to a pixel size of 0.0015 degree.
fr: Exemple simple de rééchantillonnage d'un raster d'une taille de pixel de 0.001 degrés vers une taille de pixel de 0.0015 degrés.

note: Tag: refpurpose
en: Resample a raster by adjusting only its skew (or rotation parameters). New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. Default is NearestNeighbor.
fr: Rééchantillonne un raster en ajustant simplement son obliquité (skew, ou paramètre de rotation). Les nouvelles valeurs des pixels sont calculées en utilisant l'algorithme de rééchantillonnage NearestNeighbor (plus proche voisin), Bilinear (Bilinéaire), Cubic (Cubique), CubicSpline (Cubique Spline) ou Lanczos. La valeur par défaut est NearestNeighbor.

note: Tag: para
en: Resample a raster by adjusting only its skew (or rotation parameters). New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. The default is NearestNeighbor which is the fastest but results in the worst interpolation.
fr: Rééchantillonne un raster en ajustant simplement son obliquité (skew, ou paramètre de rotation). Les nouvelles valeurs des pixels sont calculées en utilisant l'algorithme de rééchantillonnage NearestNeighbor (plus proche voisin), Bilinear (Bilinéaire), Cubic (Cubique), CubicSpline (Cubique Spline) ou Lanczos. La valeur par défaut est NearestNeighbor, qui est le plus rapide mais donne le moins bon résultat.

note: Tag: para
en: <varname>skewx</varname> and <varname>skewy</varname> define the new skew.
fr: <varname>skewx</varname> et <varname>skewy</varname> définissent la nouvelle obliquité.

note: Tag: para
en: The extent of the new raster will encompass the extent of the provided raster.
fr: L'étendue du nouveau raster englobe l'étendu du raster en entrée.

note: Tag: para
en: A maxerror percent of 0.125 if no <varname>maxerr</varname> is specified.
fr: Un pourcentage maximal d'erreur de 0.125 % est utilisé si le paramètre <varname>maxerr</varname> n'est pas spécifié.

note: Tag: para
en: ST_Reskew is different from <xref linkend="RT_ST_SetSkew"/> in that ST_SetSkew do not resample the raster to match the raster extent. ST_SetSkew only changes the metadata (or georeference) of the raster to correct an originally mis-specified skew. ST_Reskew results in a raster having different width and height computed to fit the geographic extent of the input raster. ST_SetSkew do not modify the width, nor the height of the raster.
fr: ST_Reskew est différent de <xref linkend="RT_ST_SetSkew"/> : ST_SetSkew ne rééchantillonne pas le raster pour correspondre à l'étendue du raster. ST_SetSkew modifie seulement les méta-données (ou la géo-référence) du raster pour corriger une obliquité incorrecte. ST_Reskew produit un raster de taille différente pour correspondre à l'étendue spatiale du raster d'entrée. ST_SetSkew ne modifie pas la largeur ou hauteur du raster.

note: Tag: para
en: A simple example reskewing a raster from a skew of 0.0 to a skew of 0.0015.
fr: Exemple simple de rééchantillonnage d'un raster d'une obliquité de 0.0 à 0.0015.

note: Tag: refpurpose
en: Resample a raster by snapping it to a grid. New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. Default is NearestNeighbor.
fr: Rééchantillonne un raster en l'accrochant sur une grille. Les nouvelles valeurs des pixels sont calculées en utilisant l'algorithme de rééchantillonnage NearestNeighbor (plus proche voisin), Bilinear (Bilinéaire), Cubic (Cubique), CubicSpline (Cubique Spline) ou Lanczos. La valeur par défaut est NearestNeighbor.

note: Tag: para
en: Resample a raster by snapping it to a grid defined by an arbitrary pixel corner (gridx &amp; gridy) and optionally a pixel size (scalex &amp; scaley). New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. The default is NearestNeighbor which is the fastest but results in the worst interpolation.
fr: Rééchantillonne un raster en l'accrochant sur une grille définie par un coin arbitraire (gridx &amp; gridy) et une taille de pixel optionnelle (scalex &amp; scaley). Les nouvelles valeurs des pixels sont calculées en utilisant l'algorithme de rééchantillonnage NearestNeighbor (plus proche voisin), Bilinear (Bilinéaire), Cubic (Cubique), CubicSpline (Cubique Spline) ou Lanczos. La valeur par défaut est NearestNeighbor, qui est le plus rapide mais donne le moins bon résultat.

note: Tag: para
en: <varname>gridx</varname> and <varname>gridy</varname> define any arbitrary pixel corner of the new grid. This is not necessarily the upper left corner of the new raster and it does not have to be inside or on the edge of the new raster extent.
fr: <varname>gridx</varname> et <varname>gridy</varname> définissent le pixel d'un coin arbitraire de la nouvelle grille. Ce n'est pas nécessairement le coin supérieur gauche du nouveau raster, et n'a pas besoin d'être à l'intérieur ou sur les bords de l'emprise du nouveau raster.

note: Tag: para
en: You can optionally define the pixel size of the new grid with <varname>scalex</varname> and <varname>scaley</varname>.
fr: Il est possible de définir une taille de pixel pour la nouvelle grille avec les paramètres optionnels <varname>scalex</varname> et <varname>scaley</varname>.

note: Tag: para
en: Use <xref linkend="RT_ST_Resample"/> if you need more control over the grid parameters.
fr: Voir <xref linkend="RT_ST_Resample"/> pour plus de contrôle sur les paramètres de la grille.

note: Tag: para
en: A simple example snapping a raster to a slightly different grid.
fr: Exemple simple d'accrochage d'un raster sur une grille légèrement différente.

note: Tag: refpurpose
en: Resize a raster to a new width/height
fr: Redimensionne un raster à une nouvelle largeur/hauteur

note: Tag: para
en: Resize a raster to a new width/height. The new width/height can be specified in exact number of pixels or a percentage of the raster's width/height. The extent of the the new raster will be the same as the extent of the provided raster.
fr: Redimensionne un raster à une nouvelle largeur/hauteur. La nouvelle largeur/hauteur peut être spécifiée comme un nombre exact de pixels ou un pourcentage de la taille du raster. L'étendue du nouveau raster est la même que le raster d'entrée.

note: Tag: para
en: New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. The default is NearestNeighbor which is the fastest but results in the worst interpolation.
fr: Les nouvelles valeurs des pixels sont calculées en utilisant l'algorithme de rééchantillonnage NearestNeighbor (plus proche voisin), Bilinear (Bilinéaire), Cubic (Cubique), CubicSpline (Cubique Spline) ou Lanczos. La valeur par défaut est NearestNeighbor, qui est le plus rapide mais donne le moins bon résultat.

note: Tag: para
en: Variant 1 expects the actual width/height of the output raster.
fr: La variante 1 attend la largeur/hauteur réelle du raster de sortie.

note: Tag: para
en: Variant 2 expects decimal values between zero (0) and one (1) indicating the percentage of the input raster's width/height.
fr: La variante 2 attend des valeurs décimales entre zéro (0) et un (1) indiquant le pourcentage de la largeur/hauteur du raster d'entrée.

note: Tag: para
en: Variant 3 takes either the actual width/height of the output raster or a textual percentage ("20%") indicating the percentage of the input raster's width/height.
fr: La variante 3 prend en compte soit la largeur/hauteur réelle du raster de sortie ou un pourcentage sous forme de texte ("20%") indiquant le pourcentage de la largeur/hauteur du raster d'entrée.

note: Tag: para
en: Availability: 2.1.0 Requires GDAL 1.6.1+
fr: Disponibilité : 2.1.0 Nécessite GDAL 1.6.1+

note: Tag: refpurpose
en: Reprojects a raster in a known spatial reference system to another known spatial reference system using specified resampling algorithm. Options are NearestNeighbor, Bilinear, Cubic, CubicSpline, Lanczos defaulting to NearestNeighbor.
fr: Reprojette un raster depuis un système de référence spatial vers un autre, en utilisant l'algorithme de rééchantillonnage spécifié. Les algorithmes possibles sont NearestNeighbor (plus proche voisin), Bilinear (Bilinéaire), Cubic (Cubique), CubicSpline (Cubique Spline) ou Lanczos. La valeur par défaut est NearestNeighbor.

note: Tag: para
en: Reprojects a raster in a known spatial reference system to another known spatial reference system using specified pixel warping algorithm. Uses 'NearestNeighbor' if no algorithm is specified and maxerror percent of 0.125 if no maxerr is specified.
fr: Reprojette un raster depuis un système de référence spatial vers un autre, en utilisant l'algorithme de rééchantillonnage spécifié. L'algorithme utilisé par défaut est NearestNeighbor si aucun n'est spécifié. Le pourcentage d'erreur maximal est 0.125 si maxerr n'est pas spécifié.

note: Tag: para
en: ST_Transform is often confused with ST_SetSRID(). ST_Transform actually changes the coordinates of a raster (and resamples the pixel values) from one spatial reference system to another, while ST_SetSRID() simply changes the SRID identifier of the raster.
fr: ST_Transform est souvent confondu avec ST_SetSRID(). ST_Transform modifie réellement les coordonnées du raster (et rééchantillonne les valeurs des pixels) d'un système de référence spatial vers un autre, alors que ST_SetSRID() change uniquement l'identifiant SRID du raster.

note: Tag: para
en: Unlike the other variants, Variant 3 requires a reference raster as <varname>alignto</varname>. The transformed raster will be transformed to the spatial reference system (SRID) of the reference raster and be aligned (ST_SameAlignment = TRUE) to the reference raster.
fr: Contrairement aux autres variantes, la variante 3 nécessite un raster de référence <varname>alignto</varname>. Le raster de sortie sera transformé dans le système de référence spatial (SRID) du raster de référence et sera aligné (ST_SameAlignment = TRUE) avec le raster de référence.

note: Tag: para
en: If you find your transformation support is not working right, you may need to set the environment variable PROJSO to the .so or .dll projection library your PostGIS is using. This just needs to have the name of the file. So for example on windows, you would in Control Panel -> System -> Environment Variables add a system variable called <varname>PROJSO</varname> and set it to <varname>libproj.dll</varname> (if you are using proj 4.6.1). You'll have to restart your PostgreSQL service/daemon after this change.
fr: Si vous constatez que la transformation ne fonctionne pas correctement, il se peut que vous deviez définir la variable d'environnement PROJSO pour la faire pointer vers le .so ou la .dll de la bibliothèque de projection utilisée par PostGIS. La variable doit simplement contenir le nom du fichier. Par exemple, sur Windows, aller dans Panneau de configuration > Système -> Variables d'environnement et ajouter une variable <varname>PROJSO</varname> avec comme valeur <varname>libproj.dll</varname> (si vous utilisez proj 4.6.1). Vous devrez redémarrer le service/daemon PostgreSQL après ce changement.

note: Tag: para
en: When transforming a coverage of tiles, you almost always want to use a reference raster to insure same alignment and no gaps in your tiles as demonstrated in example: Variant 3.
fr: Lors de la transformation d'une couverture tuilée, vous voudrez en général utiliser un raster de référence pour garantir le même alignement et sans lacunes dans les tuiles, comme le montre l'exemple Variante 3.

note: Tag: para
en: Enhanced: 2.1.0 Addition of ST_Transform(rast, alignto) variant
fr: Amélioration : 2.1.0 Ajout de la variante ST_Transform(rast, alignto)

note: Tag: para
en: original mass state plane meters (mass_stm)
fr: mass_stm original

note: Tag: para
en: After transform to wgs 84 long lat (wgs_84)
fr: Après transformation en WGS84 long lat (wgs_84)

note: Tag: para
en: After transform to wgs 84 long lat with bilinear algorithm instead of NN default (wgs_84_bilin)
fr: Après transformation en WGS84 long lat avec interpolation bilinéaire au lieu de NN par défaut (wgs_84_bilin)

note: Tag: para
en: The following shows the difference between using ST_Transform(raster, srid) and ST_Transform(raster, alignto)
fr: L'exemple suivant montre la différence entre ST_Transform(raster, srid) et ST_Transform(raster, alignto)

note: Tag: para
en: not_aligned
fr: Non aligné (not_aligned)

note: Tag: para
en: aligned
fr: Aligné (aligned)

note: Tag: title
en: Raster Band Editors
fr: Éditeurs de bandes raster

note: Tag: refpurpose
en: Sets the value for the given band that represents no data. Band 1 is assumed if no band is specified. To mark a band as having no nodata value, set the nodata value = NULL.
fr: Définit la valeur pour l'absence de données (nodata) pour la bande spécifiée. Si aucune bande n'est spécifiée, la bande 1 est utilisée. Pour indiquer qu'une bande n'a pas de valeur nodata, définir la valeur nodata = NULL.

note: Tag: para
en: Sets the value that represents no data for the band. Band 1 is assumed if not specified. This will affect results from <xref linkend="RT_ST_Polygon"/>, <xref linkend="RT_ST_DumpAsPolygons"/>, and the ST_PixelAs...() functions.
fr: Définit la valeur pour l'absence de données (nodata) pour la bande spécifiée. Si aucune bande n'est spécifiée, la bande 1 est utilisée. Cette valeur affecte les résultats de <xref linkend="RT_ST_Polygon"/>, <xref linkend="RT_ST_DumpAsPolygons"/>, ainsi que les fonctions ST_PixelAs...().

note: Tag: refpurpose
en: Sets the isnodata flag of the band to TRUE.
fr: Définit la valeur du flag isnodata de la bande à TRUE.

note: Tag: para
en: Sets the isnodata flag for the band to true. Band 1 is assumed if not specified. This function should be called only when the flag is considered dirty. That is, when the result calling <xref linkend="RT_ST_BandIsNoData"/> is different using TRUE as last argument and without using it
fr: Définit la valeur du flag isnodata de la bande à TRUE. Si aucune bande n'est spécifiée, la bande 1 est utilisée. Cette fonction ne devrait être appelée que si le flag est considéré comme obsolète, i.e. si le résultat de <xref linkend="RT_ST_BandIsNoData"/> est différent selon qu'on utilise TRUE comme dernier argument ou non

note: Tag: refpurpose
en: Update the external path and band number of an out-db band
fr: Met à jour le chemin externe et le numéro de bande d'une bande out-db

note: Tag: para
en: Updates an out-db band's external raster file path and external band number.
fr: Met à jour le chemin externe et le numéro de bande d'une bande externe out-db.

note: Tag: para
en: If <varname>force</varname> is set to true, no tests are done to ensure compatibility (e.g. alignment, pixel support) between the external raster file and the PostGIS raster. This mode is intended for file system changes where the external raster resides.
fr: Si <varname>force</varname> est true, aucun test n'est effectué pour garantir la compatibilité (e.g. alignement, support des pixels) entre le fichier raster externe et le raster PostGIS. Ce mode est prévu pour les changements sur le système de fichiers où réside le raster externe.

note: Tag: para
en: Internally, this method replaces the PostGIS raster's band at index <varname>band</varname> with a new band instead of updating the existing path information.
fr: En interne, cette méthode remplacement la bande du raster PostGIS à l'index <varname>band</varname> avec la nouvelle bande, au lieu de mettre à jour les informations de chemin existantes.

note: Tag: refpurpose
en: Update the external band number of an out-db band
fr: Met à jour le numéro de bande externe d'une bande out-db

note: Tag: para
en: Updates an out-db band's external band number. This does not touch the external raster file associated with the out-db band
fr: Met à jour le numéro de bande externe d'une bande out-db. Cette opération n'affecte pas le fichier raster externe associé à la bande out-db

note: Tag: para
en: If <varname>force</varname> is set to true, no tests are done to ensure compatibility (e.g. alignment, pixel support) between the external raster file and the PostGIS raster. This mode is intended for where bands are moved around in the external raster file.
fr: Si <varname>force</varname> est true, aucun test n'est effectué pour assurer la compatibilité (e.g., l'alignement, le support des pixels) entre le fichier raster externe et le raster PostGIS. Ce mode est destiné aux cas où les bandes sont déplacées dans le fichier raster externe.

note: Tag: title
en: Raster Band Statistics and Analytics
fr: Statistiques et analyses des bandes raster

note: Tag: refpurpose
en: Returns the number of pixels in a given band of a raster or raster coverage. If no band is specified defaults to band 1. If exclude_nodata_value is set to true, will only count pixels that are not equal to the nodata value.
fr: Renvoie le nombre de pixels dans une bande donnée d'un raster ou d'une couverture raster. Si aucune bande n'est spécifiée, la valeur par défaut est la bande 1. Si exclude_nodata_value est true, seuls les pixels dont la valeur est différente de la valeur nodata seront comptés.

note: Tag: para
en: Returns the number of pixels in a given band of a raster or raster coverage. If no band is specified <varname>nband</varname> defaults to 1.
fr: Renvoie le nombre de pixels dans une bande donnée d'un raster ou d'une couverture raster. Si aucune bande <varname>nband</varname> n'est spécifiée, la valeur par défaut est 1.

note: Tag: para
en: If <varname>exclude_nodata_value</varname> is set to true, will only count pixels with value not equal to the <varname>nodata</varname> value of the raster. Set <varname>exclude_nodata_value</varname> to false to get count all pixels
fr: Si <varname>exclude_nodata_value</varname> est true, seuls les pixels dont la valeur est différente de la valeur <varname>nodata</varname> du raster seront comptés. Définir <varname>exclude_nodata_value</varname> à false pour compter tous les pixels

note: Tag: para
en: Changed: 3.1.0 - The ST_Count(rastertable, rastercolumn, ...) variants removed. Use <xref linkend="RT_ST_CountAgg"/> instead.
fr: Changement : 3.1.0 - Suppression des variantes ST_Count(rastertable, rastercolumn, ...). Utiliser <xref linkend="RT_ST_CountAgg"/> à la place.

note: Tag: refpurpose
en: Aggregate. Returns the number of pixels in a given band of a set of rasters. If no band is specified defaults to band 1. If exclude_nodata_value is set to true, will only count pixels that are not equal to the NODATA value.
fr: Agrégat. Renvoie le nombre de pixels dans une bande donnée d'un ensemble de rasters. Si aucune bande n'est spécifiée, la valeur par défaut est la bande 1. Si exclude_nodata_value est true, seuls les pixels différents de la valeur NODATA seront comptés.

note: Tag: para
en: Returns the number of pixels in a given band of a set of rasters. If no band is specified <varname>nband</varname> defaults to 1.
fr: Renvoie le nombre de pixels dans une bande donnée d'un ensemble de rasters. Si aucune bande <varname>nband</varname> n'est spécifiée, la valeur par défaut est 1.

note: Tag: para
en: If <varname>exclude_nodata_value</varname> is set to true, will only count pixels with value not equal to the <varname>NODATA</varname> value of the raster. Set <varname>exclude_nodata_value</varname> to false to get count all pixels
fr: Si <varname>exclude_nodata_value</varname> est true, seuls les pixels dont la valeur est différente de la valeur <varname>nodata</varname> du raster seront comptés. Définir <varname>exclude_nodata_value</varname> à false pour compter tous les pixels

note: Tag: para
en: By default will sample all pixels. To get faster response, set <varname>sample_percent</varname> to value between zero (0) and one (1)
fr: Par défaut, tous les pixels sont échantillonnés. Pour obtenir une réponse plus rapide, définir <varname>sample_percent</varname> à une valeur comprise entre zéro (0) et un (1)

note: Tag: refpurpose
en: Returns a set of record summarizing a raster or raster coverage data distribution separate bin ranges. Number of bins are autocomputed if not specified.
fr: Retourne un ensemble d'enregistrements résumant une distribution de données raster ou de couverture raster, dans des classes distinctes. Le nombre de classes est calculé automatiquement s'il n'est pas spécifié.

note: Tag: para
en: Returns set of records consisting of min, max, count, percent for a given raster band for each bin. If no band is specified <varname>nband</varname> defaults to 1.
fr: Retourne un ensemble d'enregistrements composés de min, max, count, percent pour une bande raster donnée pour chaque classe. Si aucune bande <varname>nband</varname> n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: By default only considers pixel values not equal to the <varname>nodata</varname> value . Set <varname>exclude_nodata_value</varname> to false to get count all pixels.
fr: Par défaut, seules les valeurs de pixels différentes de la valeur <varname>nodata</varname> sont prises en compte. Définir <varname>exclude_nodata_value</varname> à false pour obtenir le comptage de tous les pixels.

note: Tag: para
en: width: an array indicating the width of each category/bin. If the number of bins is greater than the number of widths, the widths are repeated.
fr: width : un tableau indiquant la largeur de chaque classe. Si le nombre de classes est supérieur au nombre de largeurs, les largeurs sont répétées.

note: Tag: para
en: Example: 9 bins, widths are [a, b, c] will have the output be [a, b, c, a, b, c, a, b, c]
fr: Exemple : 9 classes, les largeurs étant [a, b, c], le résultat sera [a, b, c, a, b, c, a, b, c]

note: Tag: para
en: Number of breakouts -- this is the number of records you'll get back from the function if specified. If not specified then the number of breakouts is autocomputed.
fr: Nombre de classes -- c'est le nombre d'enregistrements retournés par la fonction si spécifié. Si non spécifié, le nombre de classes est calculé automatiquement.

note: Tag: para
en: compute the histogram from the right rather than from the left (default). This changes the criteria for evaluating a value x from [a, b) to (a, b]
fr: calcule l'histogramme à partir de la droite plutôt que de la gauche (par défaut). Cela modifie les critères d'évaluation d'une valeur x de [a, b) à (a, b]

note: Tag: para
en: Changed: 3.1.0 Removed ST_Histogram(table_name, column_name) variant.
fr: Changement : 3.1.0 Suppression de la variante ST_Histogram(table_name, column_name).

note: Tag: title
en: Example: Single raster tile - compute histograms for bands 1, 2, 3 and autocompute bins
fr: Exemple : Une seule tuile raster - calcul des histogrames pour les bandes 1, 2, 3 avec calcul automatique des classes

note: Tag: title
en: Example: Just band 2 but for 6 bins
fr: Exemple : Seulement la bande 2, mais avec 6 classes

note: Tag: refpurpose
en: <refpurpose>Compute quantiles for a raster or raster table coverage in the context of the sample or population. Thus, a value could be examined to be at the raster's 25%, 50%, 75% percentile.</refpurpose>
fr: <refpurpose>Calcule les quantiles d'un raster ou d'une couverture raster, dans le contexte de l'échantillon ou de la population. Ainsi, une valeur peut être examinée pour se situer au percentile de 25%, 50% ou 75% du raster.</refpurpose>

note: Tag: para
en: <para>Compute quantiles for a raster or raster table coverage in the context of the sample or population. Thus, a value could be examined to be at the raster's 25%, 50%, 75% percentile.</para>
fr: <para>Calcule les quantiles d'un raster ou d'une couverture raster, dans le contexte de l'échantillon ou de la population. Ainsi, une valeur peut être examinée pour se situer au percentile de 25%, 50% ou 75% du raster.</para>

note: Tag: para
en: If <varname>exclude_nodata_value</varname> is set to false, will also count pixels with no data.
fr: Si <varname>exclude_nodata_value</varname> est false, les pixels de valeur nodata seront également pris en compte.

note: Tag: para
en: Changed: 3.1.0 Removed ST_Quantile(table_name, column_name) variant.
fr: Changement : 3.1.0 Suppression de la variante ST_Quantile(table_name, column_name).

note: Tag: refpurpose
en: Returns summarystats consisting of count, sum, mean, stddev, min, max for a given raster band of a raster or raster coverage. Band 1 is assumed is no band is specified.
fr: Retourne des résumés statistiques (count, sum, mean, stddev, min, max) pour une bande raster ou une couverture raster spécifiée. Si aucune bande n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: Returns <xref linkend="summarystats"/> consisting of count, sum, mean, stddev, min, max for a given raster band of a raster or raster coverage. If no band is specified <varname>nband</varname> defaults to 1.
fr: Retourne un résumé statistique <xref linkend="summarystats"/> composé de count, sum, mean, stddev, min, max pour une bande raster ou une couverture raster spécifiée. Si aucune bande <varname>nband</varname> n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: By default only considers pixel values not equal to the <varname>nodata</varname> value. Set <varname>exclude_nodata_value</varname> to false to get count of all pixels.
fr: Par défaut, seules les valeurs de pixels différentes de la valeur <varname>nodata</varname> sont prises en compte. Définir <varname>exclude_nodata_value</varname> à false pour obtenir le comptage de tous les pixels.

note: Tag: para
en: By default will sample all pixels. To get faster response, set <varname>sample_percent</varname> to lower than 1
fr: Par défaut, tous les pixels sont échantillonnés. Pour obtenir une réponse plus rapide, définir <varname>sample_percent</varname> à une valeur inférieure à 1

note: Tag: para
en: Changed: 3.1.0 ST_SummaryStats(rastertable, rastercolumn, ...) variants are removed. Use <xref linkend="RT_ST_SummaryStatsAgg"/> instead.
fr: Changement : 3.1.0 Suppression des variantes ST_SummaryStats(rastertable, rastercolumn, ...). Utiliser <xref linkend="RT_ST_SummaryStatsAgg"/> à la place.

note: Tag: title
en: Example: Single raster tile
fr: Exemple : Une seule tuile raster

note: Tag: title
en: Example: Summarize pixels that intersect buildings of interest
fr: Exemple : Statistiques des pixels qui intersectent des bâtiments d'intérêt

note: Tag: para
en: This example took 574ms on PostGIS windows 64-bit with all of Boston Buildings and aerial Tiles (tiles each 150x150 pixels ~ 134,000 tiles), ~102,000 building records
fr: Cet exemple a pris 574 ms sur PostGIS Windows 64-bit avec tous les bâtiments de Boston et les tuiles aériennes (tuiles de 150x150 pixels chacune ~ 134 000 tuiles), ~102 000 enregistrements de bâtiments

note: Tag: title
en: Example: Raster coverage
fr: Exemple : Couverture raster

note: Tag: refpurpose
en: Aggregate. Returns summarystats consisting of count, sum, mean, stddev, min, max for a given raster band of a set of raster. Band 1 is assumed is no band is specified.
fr: Agrégat. Retourne des résumés statistiques (count, sum, mean, stddev, min, max) pour une bande raster spécifiée pour une ensemble de rasters. Si aucune bande n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: By default only considers pixel values not equal to the <varname>NODATA</varname> value. Set <varname>exclude_nodata_value</varname> to False to get count of all pixels.
fr: Par défaut, seules les valeurs de pixels différentes de la valeur <varname>NODATA</varname> sont prises en compte. Définir <varname>exclude_nodata_value</varname> à false pour obtenir le comptage de tous les pixels.

note: Tag: para
en: By default will sample all pixels. To get faster response, set <varname>sample_percent</varname> to value between 0 and 1
fr: Par défaut, tous les pixels sont échantillonnés. Pour obtenir une réponse plus rapide, définir <varname>sample_percent</varname> à une valeur comprise entre zéro (0) et un (1)

note: Tag: refpurpose
en: Returns a set of records containing a pixel band value and count of the number of pixels in a given band of a raster (or a raster coverage) that have a given set of values. If no band is specified defaults to band 1. By default nodata value pixels are not counted. and all other values in the pixel are output and pixel band values are rounded to the nearest integer.
fr: Retourne un ensemble d'enregistrements contenant une valeur de pixels et le nombre de pixels ayant cette valeur dans la bande du raster spécifié (ou de la couverture raster). Si aucune bande n'est spécifiée, la bande 1 est utilisée. Par défaut, les pixels de valeur nodata ne sont pas comptés, et toutes les autres valeurs sont retournées, avec leur valeur arrondies à l'entier le plus proche.

note: Tag: para
en: Returns a set of records with columns <varname>value</varname> <varname>count</varname> which contain the pixel band value and count of pixels in the raster tile or raster coverage of selected band.
fr: Retourne un ensemble d'enregistrements contenant les colonnes <varname>value</varname> <varname>count</varname>, correspondant à la valeur de pixel dans la bande et le nombre de pixels ayant cette valeur dans la bande du raster spécifié (ou de la couverture raster).

note: Tag: para
en: If no band is specified <varname>nband</varname> defaults to 1. If no <varname>searchvalues</varname> are specified, will return all pixel values found in the raster or raster coverage. If one searchvalue is given, will return an integer instead of records denoting the count of pixels having that pixel band value
fr: Si aucune bande <varname>nband</varname> n'est spécifiée, la bande 1 est utilisée. Si aucune valeur <varname>searchvalues</varname> n'est spécifiée, retourne toutes les valeurs de pixel trouvées dans le raster ou dans la couverture raster. Si une valeur searchvalue est spécifiée, retourne un entier au lieu d'enregistrements, correspondant au nombre de pixels ayant la valeur recherchée

note: Tag: title
en: Raster Inputs
fr: Import de raster

note: Tag: refpurpose
en: Return a raster value from a Well-Known Binary (WKB) raster.
fr: Retourne un raster à partir d'un raster Well-Known Binary (WKB).

note: Tag: para
en: Given a Well-Known Binary (WKB) raster, return a raster.
fr: Construit un raster PostGIS à partir d'une représentation raster Well-Known Binary (WKB).

note: Tag: refpurpose
en: Return a raster value from a Hex representation of Well-Known Binary (WKB) raster.
fr: Retourne un raster à partir d'un raster Well-Known Binary (WKB) en hexadécimal.

note: Tag: para
en: Given a Well-Known Binary (WKB) raster in Hex representation, return a raster.
fr: Construit un raster PostGIS à partir d'une représentation hexadécimale raster Well-Known Binary (WKB).

note: Tag: title
en: Raster Outputs
fr: Export de raster

note: Tag: refpurpose
en: Return the Well-Known Binary (WKB) representation of the raster.
fr: Retourne la représentation Well-Known Binary (WKB) de ce raster.

note: Tag: para
en: Returns the Binary representation of the raster. If <varname>outasin</varname> is TRUE, out-db bands are treated as in-db. Refer to raster/doc/RFC2-WellKnownBinaryFormat located in the PostGIS source folder for details of the representation.
fr: Retourne la représentation binaire du raster. Si <varname>outasin</varname> est TRUE, les bandes out-db sont traitées comme in-db. Voir raster/doc/RFC2-WellKnownBinaryFormat situé dans le dossier source de PostGIS pour plus de détails sur la représentation.

note: Tag: para
en: This is useful in binary cursors to pull data out of the database without converting it to a string representation.
fr: Cette fonction est utile dans les curseurs binaires pour extraire des données de la base de données sans les convertir en une représentation sous forme de chaîne de caractères.

note: Tag: para
en: By default, WKB output contains the external file path for out-db bands. If the client does not have access to the raster file underlying an out-db band, set <varname>outasin</varname> to TRUE.
fr: Par défaut, la sortie WKB contient le chemin d'accès au fichier externe pour les bandes out-db. Si le client n'a pas accès au fichier raster sous-jacent d'une bande out-db, définir <varname>outasin</varname> à TRUE.

note: Tag: para
en: Enhanced: 2.1.0 Addition of <varname>outasin</varname>
fr: Amélioration : 2.1.0 Ajout de <varname>outasin</varname>

note: Tag: para
en: Enhanced: 2.5.0 Addition of <varname>ST_AsWKB</varname>
fr: Amélioration : 2.5.0 Ajout de <varname>ST_AsWKB</varname>

note: Tag: refpurpose
en: Return the Well-Known Binary (WKB) in Hex representation of the raster.
fr: Retourne la représentation hexadécimale Well-Known Binary (WKB) de ce raster.

note: Tag: para
en: Returns the Binary representation in Hex representation of the raster. If <varname>outasin</varname> is TRUE, out-db bands are treated as in-db. Refer to raster/doc/RFC2-WellKnownBinaryFormat located in the PostGIS source folder for details of the representation.
fr: Retourne la représentation binaire en hexadécimal du raster. Si <varname>outasin</varname> est TRUE, les bandes out-db sont traitées comme in-db. Voir raster/doc/RFC2-WellKnownBinaryFormat situé dans le dossier source de PostGIS pour les détails de la représentation.

note: Tag: para
en: By default, Hex WKB output contains the external file path for out-db bands. If the client does not have access to the raster file underlying an out-db band, set <varname>outasin</varname> to TRUE.
fr: Par défaut, la sortie Hex WKB contient le chemin d'accès au fichier externe pour les bandes out-db. Si le client n'a pas accès au fichier raster sous-jacent de la bande out-db, définir <varname>outasin</varname> à TRUE.

note: Tag: refpurpose
en: Return the raster tile in the designated GDAL Raster format. Raster formats are one of those supported by your compiled library. Use ST_GDALDrivers() to get a list of formats supported by your library.
fr: Retourne la tuile raster dans le format GDAL raster spécifié. Les formats raster disponibles sont ceux supportés par votre bibliothèque compilée. Utilisez ST_GDALDrivers() pour obtenir la liste des formats supportés par votre bibliothèque.

note: Tag: para
en: Returns the raster tile in the designated format. Arguments are itemized below:
fr: Retourne la tuile raster dans le format spécifié. Les paramètres sont détaillés ci-dessous :

note: Tag: para
en: <varname>format</varname> format to output. This is dependent on the drivers compiled in your libgdal library. Generally available are 'JPEG', 'GTIff', 'PNG'. Use <xref linkend="RT_ST_GDALDrivers"/> to get a list of formats supported by your library.
fr: <varname>format</varname> format de sortie. Cela dépend des drivers compilés dans votre bibliothèque libgdal. Les formats généralement disponibles sont 'JPEG', 'GTIff', 'PNG'. Utilisez <xref linkend="RT_ST_GDALDrivers"/> pour obtenir une liste des formats pris en charge par votre bibliothèque.

note: Tag: para
en: <varname>options</varname> text array of GDAL options. Valid options are dependent on the format. Refer to <ulink url="http://www.gdal.org/frmt_various.html">GDAL Raster format options</ulink> for more details.
fr: <varname>options</varname> tableau textuel d'options GDAL. Les options valides dépendent du format. Pour plus de détails, voir <ulink url="http://www.gdal.org/frmt_various.html">GDAL Raster format options</ulink>.

note: Tag: para
en: <varname>srs</varname> The proj4text or srtext (from spatial_ref_sys) to embed in the image
fr: <varname>srs</varname> La chaîne proj4text ou srtext (issue de spatial_ref_sys) à incorporer dans l'image

note: Tag: title
en: JPEG Output Example, multiple tiles as single raster
fr: Exemple de sortie JPEG, plusieurs tuiles en un seul raster

note: Tag: title
en: Using PostgreSQL Large Object Support to export raster
fr: Utilisation de PostgreSQL Large Object Support pour exporter des données raster

note: Tag: para
en: One way to export raster into another format is using <ulink url="https://www.postgresql.org/docs/current/static/lo-funcs.html">PostgreSQL large object export functions</ulink>. We'lll repeat the prior example but also exporting. Note for this you'll need to have super user access to db since it uses server side lo functions. It will also export to path on server network. If you need export locally, use the psql equivalent lo_ functions which export to the local file system instead of the server file system.
fr: Une façon d'exporter des données raster vers un autre format est d'utiliser <ulink url="https://www.postgresql.org/docs/current/static/lo-funcs.html">les fonctions d'exportation de grands objets de PostgreSQL</ulink>. Nous allons reprendre l'exemple précédent en ajoutant l'export. Notez que vous devrez avoir un accès super utilisateur à la base de données car elle utilise les fonctions lo côté serveur. L'exportation se fera également vers un chemin d'accès sur le réseau du serveur. Si vous avez besoin d'exporter localement, utilisez les fonctions lo_ équivalentes de psql qui exportent vers le système de fichiers local au lieu du système de fichiers du serveur.

note: Tag: title
en: GTIFF Output Examples
fr: Exemples de sorties GTIFF

note: Tag: refpurpose
en: Return the raster tile selected bands as a single Joint Photographic Exports Group (JPEG) image (byte array). If no band is specified and 1 or more than 3 bands, then only the first band is used. If only 3 bands then all 3 bands are used and mapped to RGB.
fr: Retourne les bandes sélectionnées du raster sous la forme d'une image JPEG (sous forme de tableau d'octets). Si aucune bande n'est spécifiée, et que le raster a 1 ou plus de 3 bandes, seule la première bande est utilisée. Si le raster a exactement 3 bandes, les 3 bandes sont utilisées et mappées en RGB.

note: Tag: para
en: Returns the selected bands of the raster as a single Joint Photographic Exports Group Image (JPEG). Use <xref linkend="RT_ST_AsGDALRaster"/> if you need to export as less common raster types. If no band is specified and 1 or more than 3 bands, then only the first band is used. If 3 bands then all 3 bands are used. There are many variants of the function with many options. These are itemized below:
fr: Retourne les bandes sélectionnées du raster sous la forme d'une seule image JPEG (Joint Photographic Exports Group Image). Utilisez <xref linkend="RT_ST_AsGDALRaster"/> si vous avez besoin d'exporter vers des types de raster moins courants. Si aucune bande n'est spécifiée, et que le raster a 1 ou plus de 3 bandes, seule la première bande est utilisée. Si le raster a exactement 3 bandes, les 3 bandes sont utilisées. Il existe de nombreuses variantes de la fonction avec de nombreuses options. Celles-ci sont détaillées ci-dessous :

note: Tag: para
en: <varname>nband</varname> is for single band exports.
fr: <varname>nband</varname> pour exporter une seule bande.

note: Tag: para
en: <varname>nbands</varname> is an array of bands to export (note that max is 3 for JPEG) and the order of the bands is RGB. e.g ARRAY[3,2,1] means map band 3 to Red, band 2 to green and band 1 to blue
fr: <varname>nbands</varname> spécifie un tableau des bandes à exporter (à noter que JPEG ne supporte que 3 bandes aux maximum). L'ordre des bandes est RGB. Par exemple, ARRAY[3,2,1] signifie que la bande 3 est la rouge, la bande 2 est la verte et la bande 1 est la bleue

note: Tag: para
en: <varname>quality</varname> number from 0 to 100. The higher the number the crisper the image.
fr: <varname>quality</varname> nombre de 0 à 100. Plus le chiffre est élevé, plus l'image est nette.

note: Tag: para
en: <varname>options</varname> text Array of GDAL options as defined for JPEG (look at create_options for JPEG <xref linkend="RT_ST_GDALDrivers"/>). For JPEG valid ones are <varname>PROGRESSIVE</varname> ON or OFF and <varname>QUALITY</varname> a range from 0 to 100 and default to 75. Refer to <ulink url="http://www.gdal.org/frmt_various.html">GDAL Raster format options</ulink> for more details.
fr: <varname>options</varname> tableau textuel d'options GDAL, parmi les options définies pour JPEG (voir create_options pour JPEG de <xref linkend="RT_ST_GDALDrivers"/>). Pour JPEG, les options disponibles sont <varname>PROGRESSIVE</varname> ON ou OFF et <varname>QUALITY</varname> une valeur de 0 à 100 et par défaut 75. Voir <ulink url="http://www.gdal.org/frmt_various.html">GDAL Raster format options</ulink> pour plus de détails.

note: Tag: title
en: Examples: Output
fr: Exemples : Export

note: Tag: refpurpose
en: Return the raster tile selected bands as a single portable network graphics (PNG) image (byte array). If 1, 3, or 4 bands in raster and no bands are specified, then all bands are used. If more 2 or more than 4 bands and no bands specified, then only band 1 is used. Bands are mapped to RGB or RGBA space.
fr: Retourne les bandes sélectionnées du raster sous la forme d'une image PNG (sous forme de tableau d'octets). Si aucune bande n'est spécifiée et que le raster a 1, 3 ou 4 bandes, toutes les bandes sont utilisées. Si aucune bande n'est spécifiée et que le raster a 2 ou plus de 4 bandes, seule la bande 1 est utilisée. Les bandes sont mappées en RGB ou RGBA.

note: Tag: para
en: Returns the selected bands of the raster as a single Portable Network Graphics Image (PNG). Use <xref linkend="RT_ST_AsGDALRaster"/> if you need to export as less common raster types. If no band is specified, then the first 3 bands are exported. There are many variants of the function with many options. If no <varname>srid</varname> is specified then then srid of the raster is used. These are itemized below:
fr: Retourne les bandes sélectionnées du raster sous la forme d'une seule PNG (image graphique portable). Utilisez <xref linkend="RT_ST_AsGDALRaster"/> si vous avez besoin d'exporter vers des types de raster moins courants. Si aucune bande n'est spécifiée, les 3 premières bandes sont exportées. Il existe de nombreuses variantes de cette fonction avec de nombreuses options. Si aucun <varname>srid</varname> n'est spécifié, c'est le srid du raster qui est utilisé. Ces options sont détaillées ci-dessous :

note: Tag: para
en: <varname>nbands</varname> is an array of bands to export (note that max is 4 for PNG) and the order of the bands is RGBA. e.g ARRAY[3,2,1] means map band 3 to Red, band 2 to green and band 1 to blue
fr: <varname>nbands</varname> spécifie un tableau des bandes à exporter (à noter que PNG ne supporte que 4 bandes aux maximum). L'ordre des bandes est RGBA. Par exemple, ARRAY[3,2,1] signifie que la bande 3 est la rouge, la bande 2 est la verte et la bande 1 est la bleue

note: Tag: para
en: <varname>compression</varname> number from 1 to 9. The higher the number the greater the compression.
fr: <varname>compression</varname> nombre de 1 à 9. Plus le chiffre est élevé, plus la compression est importante.

note: Tag: para
en: <varname>options</varname> text Array of GDAL options as defined for PNG (look at create_options for PNG of <xref linkend="RT_ST_GDALDrivers"/>). For PNG valid one is only ZLEVEL (amount of time to spend on compression -- default 6) e.g. ARRAY['ZLEVEL=9']. WORLDFILE is not allowed since the function would have to output two outputs. Refer to <ulink url="http://www.gdal.org/frmt_various.html">GDAL Raster format options</ulink> for more details.
fr: <varname>options</varname> tableau textuel d'options GDAL, parmi les options définies pour PNG (voir create_options pour PNG de <xref linkend="RT_ST_GDALDrivers"/>). Pour PNG, seule l'option ZLEVEL est valide (temps à consacrer à la compression -- par défaut 6), par exemple ARRAY['ZLEVEL=9']. WORLDFILE n'est pas autorisé car la fonction devrait produire deux sorties. Voir <ulink url="http://www.gdal.org/frmt_various.html">GDAL Raster format options</ulink> pour plus de détails.

note: Tag: refpurpose
en: Return the raster selected bands as a single TIFF image (byte array). If no band is specified or any of specified bands does not exist in the raster, then will try to use all bands.
fr: Retourne les bandes sélectionnées du raster sous la forme d'une seule image TIFF (sous forme de tableau d'octets). Si aucune bande n'est spécifiée ou si l'une des bandes spécifiées n'existe pas dans le raster, toutes les bandes sont utilisées.

note: Tag: para
en: Returns the selected bands of the raster as a single Tagged Image File Format (TIFF). If no band is specified, will try to use all bands. This is a wrapper around <xref linkend="RT_ST_AsGDALRaster"/>. Use <xref linkend="RT_ST_AsGDALRaster"/> if you need to export as less common raster types. There are many variants of the function with many options. If no spatial reference SRS text is present, the spatial reference of the raster is used. These are itemized below:
fr: Retourne les bandes sélectionnées du raster sous la forme d'un fichier TIFF (Tagged Image File Format). Si aucune bande n'est spécifiée, toutes les bandes seront utilisées. Cette fonction est une enveloppe autour de <xref linkend="RT_ST_AsGDALRaster"/>. Utilisez <xref linkend="RT_ST_AsGDALRaster"/> si vous avez besoin d'exporter vers des types de raster moins courants. Il existe de nombreuses variantes de la fonction avec de nombreuses options. Si aucun texte SRS de référence spatiale n'est présent, la référence spatiale du raster est utilisée. Ces options sont détaillées ci-dessous :

note: Tag: para
en: <varname>nbands</varname> is an array of bands to export (note that max is 3 for PNG) and the order of the bands is RGB. e.g ARRAY[3,2,1] means map band 3 to Red, band 2 to green and band 1 to blue
fr: <varname>nbands</varname> spécifie un tableau des bandes à exporter (à noter que PNG ne supporte que 3 bandes aux maximum). L'ordre des bandes est RGB. Par exemple, ARRAY[3,2,1] signifie que la bande 3 est la rouge, la bande 2 est la verte et la bande 1 est la bleue

note: Tag: para
en: <varname>compression</varname> Compression expression -- JPEG90 (or some other percent), LZW, JPEG, DEFLATE9.
fr: <varname>compression</varname> Expression de compression -- JPEG90 (ou un autre pourcentage), LZW, JPEG, DEFLATE9.

note: Tag: para
en: <varname>options</varname> text Array of GDAL create options as defined for GTiff (look at create_options for GTiff of <xref linkend="RT_ST_GDALDrivers"/>). or refer to <ulink url="http://www.gdal.org/frmt_various.html">GDAL Raster format options</ulink> for more details.
fr: <varname>options</varname> tableau textuel d'options GDAL, parmi les options définies pour GTiff (voir create_options pour GTiff de <xref linkend="RT_ST_GDALDrivers"/>). Voir <ulink url="http://www.gdal.org/frmt_various.html">GDAL Raster format options</ulink> pour plus de détails.

note: Tag: para
en: <varname>srid</varname> srid of spatial_ref_sys of the raster. This is used to populate the georeference information
fr: <varname>srid</varname> srid du système de référence spatial du raster. Il est utilisé pour remplir les informations de géo-référence

note: Tag: title
en: Examples: Use jpeg compression 90%
fr: Exemple : Utiliser la compression jpeg à 90%

note: Tag: title
en: Raster Processing: Map Algebra
fr: Traitement des données raster : algèbre cartographique

note: Tag: refpurpose
en: Returns the raster clipped by the input geometry. If band number not is specified, all bands are processed. If <varname>crop</varname> is not specified or TRUE, the output raster is cropped.
fr: Retourne le raster coupé par la géométrie d'entrée. Si le numéro de bande n'est pas spécifié, toutes les bandes sont traitées. Si <varname>crop</varname> n'est pas spécifié ou est TRUE, le raster de sortie est recadré.

note: Tag: para
en: Returns a raster that is clipped by the input geometry <varname>geom</varname>. If band index is not specified, all bands are processed.
fr: Retourne un raster coupé par la géométrie d'entrée <varname>geom</varname>. Si l'index des bandes n'est pas spécifié, toutes les bandes sont traitées.

note: Tag: para
en: Rasters resulting from ST_Clip must have a nodata value assigned for areas clipped, one for each band. If none are provided and the input raster do not have a nodata value defined, nodata values of the resulting raster are set to ST_MinPossibleValue(ST_BandPixelType(rast, band)). When the number of nodata value in the array is smaller than the number of band, the last one in the array is used for the remaining bands. If the number of nodata value is greater than the number of band, the extra nodata values are ignored. All variants accepting an array of nodata values also accept a single value which will be assigned to each band.
fr: Les rasters résultant de ST_Clip doivent avoir une valeur de nodata assignée pour les zones découpées, une pour chaque bande. Si aucune valeur n'est fournie et que le raster d'entrée n'a pas de valeur de nodata définie, les valeurs de nodata du raster résultant sont fixées à ST_MinPossibleValue(ST_BandPixelType(rast, band)). Lorsque la taille du tableau nodata inférieure au nombre de bandes, la dernière valeur du tableau est utilisée pour les bandes restantes. Si la taille du tableau nodata est supérieure au nombre de bandes, les valeurs de nodata supplémentaires sont ignorées. Toutes les variantes acceptant un tableau de valeurs de nodata acceptent également une valeur unique qui sera assignée à chaque bande.

note: Tag: para
en: If <varname>crop</varname> is not specified, true is assumed meaning the output raster is cropped to the intersection of the <varname>geom</varname>and <varname>rast</varname> extents. If <varname>crop</varname> is set to false, the new raster gets the same extent as <varname>rast</varname>.
fr: Si <varname>crop</varname> n'est pas spécifié, true est utilisé par défaut, signifiant que le raster de sortie est recadré à l'intersection des étendues de <varname>geom</varname>et <varname>rast</varname>. Si <varname>crop</varname> est défini à false, le nouveau raster a la même étendue que <varname>rast</varname>.

note: Tag: para
en: Enhanced: 2.1.0 Rewritten in C
fr: Amélioration : 2.1.0 Réécrit en C

note: Tag: para
en: Examples here use Massachusetts aerial data available on MassGIS site <ulink url="http://www.mass.gov/mgis/colororthos2008.htm">MassGIS Aerial Orthos</ulink>. Coordinates are in Massachusetts State Plane Meters.
fr: Les exemples présentés ici utilisent les données aériennes du Massachusetts disponibles sur le site MassGIS <ulink url="http://www.mass.gov/mgis/colororthos2008.htm">MassGIS Aerial Orthos</ulink>. Les coordonnées sont exprimées en mètres (Massachusetts State Plane Meters).

note: Tag: title
en: Examples: 1 band clipping
fr: Exemples : Coupe d'une bande

note: Tag: para
en: Full raster tile before clipping
fr: Tuile raster complète avant découpe

note: Tag: para
en: After Clipping
fr: Après découpe

note: Tag: title
en: Examples: 1 band clipping with no crop and add back other bands unchanged
fr: Exemples : Coupe d'une bande sans recadrage et ajout d'autres bandes inchangées

note: Tag: para
en: After Clipping - surreal
fr: Après découpe - surréaliste

note: Tag: title
en: Examples: Clip all bands
fr: Exemples : Coupe de toutes les bandes

note: Tag: refpurpose
en: Creates a new raster of up to four 8BUI bands (grayscale, RGB, RGBA) from the source raster and a specified band. Band 1 is assumed if not specified.
fr: Crée un nouveau raster comprenant jusqu'à quatre bandes 8BUI (niveaux de gris, RGB, RGBA) à partir du raster source et d'une bande spécifiée. Si aucune bande n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: Apply a <varname>colormap</varname> to the band at <varname>nband</varname> of <varname>rast</varname> resulting a new raster comprised of up to four 8BUI bands. The number of 8BUI bands in the new raster is determined by the number of color components defined in <varname>colormap</varname>.
fr: Appliquer une palette de couleurs <varname>colormap</varname> à la bande <varname>nband</varname> du raster <varname>rast</varname>, pour obtenir un nouveau raster comprenant jusqu'à quatre bandes 8BUI. Le nombre de bandes 8BUI dans le nouveau raster est déterminé par le nombre de composantes de couleur définies dans <varname>colormap</varname>.

note: Tag: para
en: If <varname>nband</varname> is not specified, then band 1 is assumed.
fr: Si <varname>nband</varname> n'est pas spécifié, la bande 1 est utilisée.

note: Tag: para
en: <varname>colormap</varname> can be a keyword of a pre-defined colormap or a set of lines defining the value and the color components.
fr: <varname>colormap</varname> peut être un mot-clé d'une palette de couleurs prédéfinie, ou un ensemble de lignes définissant la valeur et les composants de couleur.

note: Tag: para
en: Valid pre-defined <varname>colormap</varname> keyword:
fr: Valeurs prédéfinies disponibles pour <varname>colormap</varname> :

note: Tag: para
en: <varname>grayscale</varname> or <varname>greyscale</varname> for a one 8BUI band raster of shades of gray.
fr: <varname>grayscale</varname> ou <varname>greyscale</varname> pour un raster à 1 bande 8BUI en nuances de gris.

note: Tag: para
en: <varname>pseudocolor</varname> for a four 8BUI (RGBA) band raster with colors going from blue to green to red.
fr: <varname>pseudocolor</varname> pour un raster à 4 bandes 8BUI (RGBA) avec des couleurs allant du bleu au rouge en passant par le vert.

note: Tag: para
en: <varname>fire</varname> for a four 8BUI (RGBA) band raster with colors going from black to red to pale yellow.
fr: <varname>fire</varname> pour un raster à 4 bandes 8BUI (RGBA) avec des couleurs allant du noir au rouge en passant par le jaune pâle.

note: Tag: para
en: <varname>bluered</varname> for a four 8BUI (RGBA) band raster with colors going from blue to pale white to red.
fr: <varname>bluered</varname> pour un raster à 4 bandes 8BUI (RGBA) avec des couleurs allant du bleu au rouge en passant par le blanc pâle.

note: Tag: para
en: Users can pass a set of entries (one per line) to <varname>colormap</varname> to specify custom colormaps. Each entry generally consists of five values: the pixel value and corresponding Red, Green, Blue, Alpha components (color components between 0 and 255). Percent values can be used instead of pixel values where 0% and 100% are the minimum and maximum values found in the raster band. Values can be separated with commas (','), tabs, colons (':') and/or spaces. The pixel value can be set to <emphasis>nv</emphasis>, <emphasis>null</emphasis> or <emphasis>nodata</emphasis> for the NODATA value. An example is provided below.
fr: Vous pouvez passer un ensemble d'entrées (une par ligne) à <varname>colormap</varname> pour spécifier des palettes de couleurs personnalisées. Chaque entrée se compose généralement de cinq valeurs : la valeur du pixel et les composantes rouge, verte, bleue et alpha correspondantes (composantes de couleur comprises entre 0 et 255). Des valeurs en pourcentage peuvent être utilisées à la place des valeurs en pixels, où 0% et 100% sont les valeurs minimales et maximales trouvées dans la bande raster. Les valeurs peuvent être séparées par des virgules (','), des tabulations, des deux-points (':') et/ou des espaces. La valeur du pixel peut être fixée à <emphasis>nv</emphasis>, <emphasis>null</emphasis> ou <emphasis>nodata</emphasis> pour la valeur NODATA. Un exemple est fourni ci-dessous.

note: Tag: para
en: The syntax of <varname>colormap</varname> is similar to that of the color-relief mode of GDAL <ulink url="http://www.gdal.org/gdaldem.html#gdaldem_color_relief">gdaldem</ulink>.
fr: La syntaxe de <varname>colormap</varname> est similaire à celle du mode couleur du relief de GDAL <ulink url="http://www.gdal.org/gdaldem.html#gdaldem_color_relief">gdaldem</ulink>.

note: Tag: para
en: Valid keywords for <varname>method</varname>:
fr: Valeurs disponibles pour <varname>method</varname> :

note: Tag: para
en: <varname>INTERPOLATE</varname> to use linear interpolation to smoothly blend the colors between the given pixel values
fr: <varname>INTERPOLATE</varname> pour utiliser l'interpolation linéaire afin de mélanger les couleurs entre les valeurs de pixels données

note: Tag: para
en: <varname>EXACT</varname> to strictly match only those pixels values found in the colormap. Pixels whose value does not match a colormap entry will be set to 0 0 0 0 (RGBA)
fr: <varname>EXACT</varname> pour correspondre strictement aux valeurs des pixels trouvés dans la palette de couleurs. Les pixels dont la valeur ne correspond pas à une entrée de la palette de couleurs seront mis à 0 0 0 0 (RGBA)

note: Tag: para
en: <varname>NEAREST</varname> to use the colormap entry whose value is closest to the pixel value
fr: <varname>NEAREST</varname> pour utiliser l'entrée de la palette de couleurs dont la valeur est la plus proche de la valeur du pixel

note: Tag: para
en: A great reference for colormaps is <ulink url="http://www.colorbrewer2.org">ColorBrewer</ulink>.
fr: Une excellente référence pour les palette de couleurs est <ulink url="http://www.colorbrewer2.org">ColorBrewer</ulink>.

note: Tag: para
en: The resulting bands of new raster will have no NODATA value set. Use <xref linkend="RT_ST_SetBandNoDataValue"/> to set a NODATA value if one is needed.
fr: Les bandes résultantes du nouveau raster n'auront pas de valeur NODATA définie. Utilisez <xref linkend="RT_ST_SetBandNoDataValue"/> pour définir une valeur NODATA si nécessaire.

note: Tag: para
en: This is a junk table to play with
fr: Définit une table de bric-à-brac pour jouer

note: Tag: title
en: Examples: Compare different color map looks using ST_AsPNG
fr: Exemples : Comparaison de différentes palettes de couleurs via ST_AsPNG

note: Tag: refpurpose
en: Creates a new one-8BUI band raster from the source raster and specified bands representing Red, Green and Blue
fr: Crée un nouveau raster à 1 bande 8BUI à partir du raster source et des bandes spécifiées représentant les composantes rouge, vert et bleu

note: Tag: para
en: Create a raster with one 8BUI band given three input bands (from one or more rasters). Any input band whose pixel type is not 8BUI will be reclassified using <xref linkend="RT_ST_Reclass"/>.
fr: Crée un raster à 1 bande 8BUI à partir de trois bandes d'entrée (provenant d'un ou plusieurs rasters). Toute bande d'entrée dont le type de pixel n'est pas 8BUI sera reclassée avec <xref linkend="RT_ST_Reclass"/>.

note: Tag: para
en: This function is not like <xref linkend="RT_ST_ColorMap"/> with the <varname>grayscale</varname> keyword as ST_ColorMap operates on only one band while this function expects three bands for RGB. This function applies the following equation for converting RGB to Grayscale: 0.2989 * RED + 0.5870 * GREEN + 0.1140 * BLUE
fr: Cette fonction est différente de <xref linkend="RT_ST_ColorMap"/> avec le mot-clé <varname>grayscale</varname>, car ST_ColorMap n'opère que sur une seule bande alors que cette fonction s'attend à trois bandes pour RGB. Cette fonction applique l'équation suivante pour convertir les composantes RGB en niveaux de gris : 0,2989 * ROUGE + 0,5870 * VERT + 0,1140 * BLEU

note: Tag: refpurpose
en: <refpurpose>Returns a raster or a set of geometry-pixelvalue pairs representing the shared portion of two rasters or the geometrical intersection of a vectorization of the raster and a geometry.</refpurpose>
fr: <refpurpose>Retourne un raster ou un ensemble de paires (géométrie, valeur de pixel) représentant la partie partagée de deux rasters ou l'intersection géométrique d'une vectorisation du raster et d'une géométrie.</refpurpose>

note: Tag: para
en: <para>Returns a raster or a set of geometry-pixelvalue pairs representing the shared portion of two rasters or the geometrical intersection of a vectorization of the raster and a geometry.</para>
fr: <para>Retourne un raster ou un ensemble de paires (géométrie, valeur de pixel) représentant la partie partagée de deux rasters ou l'intersection géométrique d'une vectorisation du raster et d'une géométrie.</para>

note: Tag: para
en: The first three variants, returning a setof geomval, works in vector space. The raster is first vectorized (using <xref linkend="RT_ST_DumpAsPolygons"/>) into a set of geomval rows and those rows are then intersected with the geometry using the <xref linkend="ST_Intersection"/> (geometry, geometry) PostGIS function. Geometries intersecting only with a nodata value area of a raster returns an empty geometry. They are normally excluded from the results by the proper usage of <xref linkend="RT_ST_Intersects"/> in the WHERE clause.
fr: Les trois premières variantes, qui retournent un ensemble de géométries, fonctionnent dans l'espace vectoriel. Le raster est d'abord vectorisé (via <xref linkend="RT_ST_DumpAsPolygons"/>) en un ensemble de lignes geomval, et ces lignes sont ensuite intersectées avec la géométrie via la fonction PostGIS <xref linkend="ST_Intersection"/> (geometry, geometry). Les géométries intersectant uniquement une zone de valeur nodata d'un raster renvoient une géométrie vide. Elles sont normalement exclues des résultats par l'utilisation correcte de <xref linkend="RT_ST_Intersects"/> dans la clause WHERE.

note: Tag: para
en: You can access the geometry and the value parts of the resulting set of geomval by surrounding them with parenthesis and adding '.geom' or '.val' at the end of the expression. e.g. (ST_Intersection(rast, geom)).geom
fr: Vous pouvez accéder aux parties géométrie et valeur de l'ensemble résultant de geomval en les entourant de parenthèses et en ajoutant '.geom' ou '.val' à la fin de l'expression. par exemple (ST_Intersection(rast, geom)).geom

note: Tag: para
en: The other variants, returning a raster, works in raster space. They are using the two rasters version of ST_MapAlgebraExpr to perform the intersection.
fr: Les autres variantes, qui retournent un raster, fonctionnent dans l'espace raster. Elles utilisent la variante de ST_MapAlgebraExpr utilisant deux rasters pour réaliser l'intersection.

note: Tag: para
en: The extent of the resulting raster corresponds to the geometrical intersection of the two raster extents. The resulting raster includes 'BAND1', 'BAND2' or 'BOTH' bands, following what is passed as the <varname>returnband</varname> parameter. Nodata value areas present in any band results in nodata value areas in every bands of the result. In other words, any pixel intersecting with a nodata value pixel becomes a nodata value pixel in the result.
fr: L'étendue du raster résultant correspond à l'intersection géométrique des deux étendues des rasters. Le raster résultant inclut les bandes 'BAND1', 'BAND2' ou 'BOTH', en fonction du paramètre <varname>returnband</varname>. Les zones de valeurs nodata présentes dans n'importe quelle bande se traduisent par des zones de valeurs nodata dans toutes les bandes du résultat. En d'autres termes, tout pixel croisant un pixel à valeur nodata devient un pixel à valeur nodata dans le résultat.

note: Tag: para
en: Rasters resulting from ST_Intersection must have a nodata value assigned for areas not intersecting. You can define or replace the nodata value for any resulting band by providing a <varname>nodataval[]</varname> array of one or two nodata values depending if you request 'BAND1', 'BAND2' or 'BOTH' bands. The first value in the array replace the nodata value in the first band and the second value replace the nodata value in the second band. If one input band do not have a nodata value defined and none are provided as an array, one is chosen using the ST_MinPossibleValue function. All variant accepting an array of nodata value can also accept a single value which will be assigned to each requested band.
fr: Les rasters résultant de ST_Intersection doivent avoir une valeur nodata assignée pour les zones non intersectées. Vous pouvez définir ou remplacer la valeur nodata pour toute bande résultante en fournissant un tableau <varname>nodataval[]</varname> d'une ou deux valeurs nodata selon que vous demandez les bandes 'BAND1', 'BAND2' ou 'BOTH'. La première valeur du tableau remplace la valeur nodata dans la première bande et la deuxième valeur remplace la valeur nodata dans la deuxième bande. Si une bande d'entrée n'a pas de valeur nodata définie et qu'aucune n'est fournie sous forme de tableau, une valeur est choisie via la fonction ST_MinPossibleValue. Toutes les variantes acceptant un tableau de valeurs nodata peuvent également accepter une valeur unique qui sera assignée à chaque bande demandée.

note: Tag: para
en: In all variants, if no band number is specified band 1 is assumed. If you need an intersection between a raster and geometry that returns a raster, refer to <xref linkend="RT_ST_Clip"/>.
fr: Dans toutes les variantes, si aucune bande n'est spécifiée, la bande 1 est utilisée. Si vous avez besoin d'une intersection entre un raster et une géométrie qui retourne un raster, utilisez <xref linkend="RT_ST_Clip"/>.

note: Tag: para
en: To get more control on the resulting extent or on what to return when encountering a nodata value, use the two rasters version of <xref linkend="RT_ST_MapAlgebraExpr2"/>.
fr: Pour mieux contrôler l'étendue résultante, ou ce qu'il faut retourner lorsqu'une valeur nodata est rencontrée, utilisez la variante à deux rasters de <xref linkend="RT_ST_MapAlgebraExpr2"/>.

note: Tag: para
en: To compute the intersection of a raster band with a geometry in raster space, use <xref linkend="RT_ST_Clip"/>. ST_Clip works on multiple bands rasters and does not return a band corresponding to the rasterized geometry.
fr: Pour calculer l'intersection d'une bande raster avec une géométrie dans l'espace raster, utilisez <xref linkend="RT_ST_Clip"/>. ST_Clip travaille sur des bandes rasters multiples et ne retourne pas de bande correspondant à la géométrie rasterisée.

note: Tag: para
en: ST_Intersection should be used in conjunction with <xref linkend="RT_ST_Intersects"/> and an index on the raster column and/or the geometry column.
fr: ST_Intersection devrait être utilisée conjointement avec <xref linkend="RT_ST_Intersects"/> et un index sur la colonne raster et/ou la colonne géométrique.

note: Tag: para
en: Enhanced: 2.0.0 - Intersection in the raster space was introduced. In earlier pre-2.0.0 versions, only intersection performed in vector space were supported.
fr: Amélioration : 2.0.0 - Ajout de l'intersection dans l'espace raster. Dans les versions antérieures à la version 2.0.0, seules les intersections réalisées dans l'espace vectoriel étaient prises en charge.

note: Tag: title
en: Examples: Geometry, Raster -- resulting in geometry vals
fr: Exemples : Géométrie, Raster -- avec pour résultat des geomval

note: Tag: refpurpose
en: Callback function version - Returns a one-band raster given one or more input rasters, band indexes and one user-specified callback function.
fr: Version avec fonction de rappel - Retourne un raster à une bande à partir d'un ou plusieurs rasters d'entrée, d'index de bandes et d'une fonction de rappel spécifiée par l'utilisateur.

note: Tag: para
en: Returns a one-band raster given one or more input rasters, band indexes and one user-specified callback function.
fr: Retourne un raster à une bande à partir d'un ou plusieurs rasters d'entrée, d'index de bandes et d'une fonction de rappel spécifiée par l'utilisateur.

note: Tag: para
en: Rasters on which the map algebra process is evaluated.
fr: Rasters sur lesquels le traitement d'algèbre cartographique est évalué.

note: Tag: para
en: <varname>rastbandargset</varname> allows the use of a map algebra operation on many rasters and/or many bands. See example Variant 1.
fr: <varname>rastbandargset</varname> permet d'utiliser une opération d'algèbre cartographique sur plusieurs rasters et/ou plusieurs bandes. Voir l'exemple Variante 1.

note: Tag: para
en: Band numbers of the raster to be evaluated. nband can be an integer or integer[] denoting the bands. nband1 is band on rast1 and nband2 is band on rast2 for hte 2 raster/2band case.
fr: Numéros de bande du raster à évaluer. nband peut être un entier ou un tableau d'entiers désignant les bandes. nband1 est la bande sur rast1 et nband2 est la bande sur rast2 pour le cas de 2 rasters/2 bandes.

note: Tag: para
en: An n-dimensional array (matrix) of numbers used to filter what cells get passed to map algebra call-back function. 0 means a neighbor cell value should be treated as no-data and 1 means value should be treated as data. If weight is set to true, then the values, are used as multipliers to multiple the pixel value of that value in the neighborhood position.
fr: Un tableau à n dimensions (matrice) de nombres utilisés pour filtrer les cellules transmises à la fonction de rappel de l'algèbre cartographique. 0 signifie que la valeur d'une cellule voisine doit être traitée comme une absence de données et 1 signifie que la valeur doit être traitée comme une donnée. Si weight est définit à true, les valeurs sont utilisées comme multiplicateurs pour multiplier la valeur du pixel par cette valeur dans la position de voisinage.

note: Tag: para
en: boolean (true/false) to denote if a mask value should be weighted (multiplied by original value) or not (only applies to proto that takes a mask).
fr: booléen (true/false) indiquant si la valeur d'un masque doit être pondérée (multipliée par la valeur originale) ou non (ne s'applique qu'aux variantes qui prennent un masque).

note: Tag: para
en: If <varname>pixeltype</varname> is passed in, the one band of the new raster will be of that pixeltype. If pixeltype is passed NULL or left out, the new raster band will have the same pixeltype as the specified band of the first raster (for extent types: INTERSECTION, UNION, FIRST, CUSTOM) or the specified band of the appropriate raster (for extent types: SECOND, LAST). If in doubt, always specify <varname>pixeltype</varname>.
fr: Si <varname>pixeltype</varname> est spécifié, l'unique bande du nouveau raster sera de ce type de pixel. Si pixeltype est NULL ou omis, la nouvelle bande du raster aura le même pixeltype que la bande spécifiée du premier raster (pour les types d'étendue : INTERSECTION, UNION, FIRST, CUSTOM) ou que la bande spécifiée du raster approprié (pour les types d'étendue : SECOND, LAST). En cas de doute, spécifiez toujours <varname>pixeltype</varname>.

note: Tag: para
en: The resulting pixel type of the output raster must be one listed in <xref linkend="RT_ST_BandPixelType"/> or left out or set to NULL.
fr: Le type de pixel résultant du raster de sortie doit correspondre à l'un des types énumérés dans <xref linkend="RT_ST_BandPixelType"/>, ou être omis ou défini à NULL.

note: Tag: para
en: Possible values are INTERSECTION (default), UNION, FIRST (default for one raster variants), SECOND, LAST, CUSTOM.
fr: Les valeurs possibles sont INTERSECTION (par défaut), UNION, FIRST (premier, par défaut pour les variantes à un seul raster), SECOND, LAST (dernier), CUSTOM (personnalisé).

note: Tag: para
en: If <varname>extentype</varname> is CUSTOM, a raster must be provided for <varname>customextent</varname>. See example 4 of Variant 1.
fr: Si <varname>extentype</varname> est CUSTOM, un raster doit être spécifié par le paramètre <varname>customextent</varname>. Voir l'exemple 4 de la variante 1.

note: Tag: para
en: The distance in pixels from the reference cell in x direction. So width of resulting matrix would be <code>2*distancex + 1</code>.If not specified only the reference cell is considered (neighborhood of 0).
fr: La distance en pixels de la cellule de référence dans la direction x. La largeur de la matrice résultante sera donc <code>2*distancex + 1</code>. Si elle n'est pas spécifiée, seule la cellule de référence est prise en compte (voisinage de 0).

note: Tag: para
en: The distance in pixels from reference cell in y direction. Height of resulting matrix would be <code>2*distancey + 1</code> .If not specified only the reference cell is considered (neighborhood of 0).
fr: La distance en pixels de la cellule de référence dans la direction y. La hauteur de la matrice résultante sera <code>2*distancey + 1</code> Si elle n'est pas spécifiée, seule la cellule de référence est prise en compte (voisinage de 0).

note: Tag: para
en: The third argument to the <varname>callbackfunc</varname> is a <type>variadic text</type> array. All trailing text arguments are passed through to the specified <varname>callbackfunc</varname>, and are contained in the <varname>userargs</varname> argument.
fr: Le troisième paramètre de la fonction <varname>callbackfunc</varname> est un tableau <type>variadic text</type> . Tous les arguments textuels supplémentaires sont transmis à <varname>callbackfunc</varname>, et sont contenus dans l'argument <varname>userargs</varname>.

note: Tag: para
en: For more information about the VARIADIC keyword, please refer to the PostgreSQL documentation and the "SQL Functions with Variable Numbers of Arguments" section of <ulink url="http://www.postgresql.org/docs/current/static/xfunc-sql.html">Query Language (SQL) Functions</ulink>.
fr: Pour plus d'informations sur le mot-clé VARIADIC, veuillez vous référer à la documentation PostgreSQL et à la section "SQL Functions with Variable Numbers of Arguments" de <ulink url="http://www.postgresql.org/docs/current/static/xfunc-sql.html">Query Language (SQL) Functions</ulink>.

note: Tag: para
en: The <type>text[]</type> argument to the <varname>callbackfunc</varname> is required, regardless of whether you choose to pass any arguments to the callback function for processing or not.
fr: Le paramètre <type>text[]</type> de la fonction <varname>callbackfunc</varname> est obligatoire, que vous choisissiez ou non de transmettre des arguments à la fonction de rappel.

note: Tag: para
en: Variant 1 accepts an array of <varname>rastbandarg</varname> allowing the use of a map algebra operation on many rasters and/or many bands. See example Variant 1.
fr: La variante 1 accepte un tableau de <varname>rastbandarg</varname> permettant l'utilisation d'une opération d'algèbre cartographique sur de nombreux masters et/ou de nombreuses bandes. Voir l'exemple de la variante 1.

note: Tag: para
en: Variants 2 and 3 operate upon one or more bands of one raster. See example Variant 2 and 3.
fr: Les variantes 2 et 3 agissent sur une ou plusieurs bandes d'un même raster. Voir l'exemple des variantes 2 et 3.

note: Tag: para
en: Variant 4 operate upon two rasters with one band per raster. See example Variant 4.
fr: La variante 4 utilise deux rasters avec une bande par raster. Voir l'exemple de la variante 4.

note: Tag: para
en: Availability: 2.2.0: Ability to add a mask
fr: Disponibilité : 2.2.0 : Possibilité d'ajouter un masque

note: Tag: para
en: One raster, one band
fr: Un raster, une bande

note: Tag: para
en: One raster, several bands
fr: Un raster, plusieurs bandes

note: Tag: para
en: Several rasters, several bands
fr: Plusieurs rasters, plusieurs bandes

note: Tag: para
en: Complete example of tiles of a coverage with neighborhood. This query only works with PostgreSQL 9.1 or higher.
fr: Exemple complet avec les tuiles d'une couverture avec voisinage. Cette requête ne fonctionne qu'avec PostgreSQL 9.1 ou plus.

note: Tag: para
en: Example like the prior one for tiles of a coverage with neighborhood but works with PostgreSQL 9.0.
fr: Exemple identique au précédent pour les tuiles d'une couverture avec voisinage, mais fonctionne avec PostgreSQL 9.0.

note: Tag: title
en: Examples: Variants 2 and 3
fr: Exemples : Variantes 2 et 3

note: Tag: title
en: Examples: Variant 4
fr: Exemples : Variante 4

note: Tag: para
en: Two rasters, two bands
fr: Deux rasters, deux bandes

note: Tag: title
en: Examples: Using Masks
fr: Exemples : Utilisation de masques

note: Tag: para
en: no mask mean value (same as having all 1s in mask matrix)
fr: valeur moyenne, sans masque (ce qui revient à avoir que des 1 dans la matrice du masque)

note: Tag: para
en: mask only consider neighbors, exclude center
fr: masque uniquement sur les voisins, en excluant le centre

note: Tag: para
en: mask weighted only consider neighbors, exclude center multi other pixel values by 2
fr: masque pondéré, uniquement sur les voisins en excluant le centre, multiplier les autres pixels par 2

note: Tag: refpurpose
en: <refpurpose>Expression version - Returns a one-band raster given one or two input rasters, band indexes and one or more user-specified SQL expressions.</refpurpose>
fr: <refpurpose>Version avec expression - Retourne un raster à une bande à partir d'un ou deux rasters d'entrée, d'index de bandes et d'une ou plusieurs expressions SQL spécifiées par l'utilisateur.</refpurpose>

note: Tag: para
en: <para>Expression version - Returns a one-band raster given one or two input rasters, band indexes and one or more user-specified SQL expressions.</para>
fr: <para>Version avec expression - Retourne un raster à une bande à partir d'un ou deux rasters d'entrée, d'index de bandes et d'une ou plusieurs expressions SQL spécifiées par l'utilisateur.</para>

note: Tag: title
en: Description: Variants 1 and 2 (one raster)
fr: Description : Variantes 1 et 2 (un raster)

note: Tag: para
en: Creates a new one band raster formed by applying a valid PostgreSQL algebraic operation defined by the <varname>expression</varname> on the input raster (<varname>rast</varname>). If <varname>nband</varname> is not provided, band 1 is assumed. The new raster will have the same georeference, width, and height as the original raster but will only have one band.
fr: Crée un nouveau raster à une bande formé en appliquant une opération algébrique PostgreSQL valide définie par <varname>expression</varname> sur le raster d'entrée (<varname>rast</varname>). Si <varname>nband</varname> n'est pas fourni, la bande 1 est utilisée. Le nouveau raster aura la même géoréférence, la même largeur et la même hauteur que le raster original mais n'aura qu'une seule bande.

note: Tag: para
en: If <varname>pixeltype</varname> is passed in, then the new raster will have a band of that pixeltype. If pixeltype is passed NULL, then the new raster band will have the same pixeltype as the input <varname>rast</varname> band.
fr: Si <varname>pixeltype</varname> est fourni, le nouveau raster aura une bande de ce type de pixel. Si pixeltype est NULL, la nouvelle bande raster aura le même type de pixel que la bande d'entrée de <varname>rast</varname>.

note: Tag: para
en: Keywords permitted for <varname>expression</varname>
fr: Mots clés possibles pour <varname>expression</varname>

note: Tag: para
en: <varname>[rast]</varname> - Pixel value of the pixel of interest
fr: <varname>[rast]</varname> - Valeur du pixel d'intérêt

note: Tag: para
en: <varname>[rast.val]</varname> - Pixel value of the pixel of interest
fr: <varname>[rast.val]</varname> - Valeur du pixel d'intérêt

note: Tag: para
en: <varname>[rast.x]</varname> - 1-based pixel column of the pixel of interest
fr: <varname>[rast.x]</varname> - colonne du pixel d'intérêt (démarrant à 1)

note: Tag: para
en: <varname>[rast.y]</varname> - 1-based pixel row of the pixel of interest
fr: <varname>[rast.y]</varname> - ligne du pixel d'intérêt (démarrant à 1)

note: Tag: title
en: Description: Variants 3 and 4 (two raster)
fr: Description : Variantes 3 et 4 (deux rasters)

note: Tag: para
en: Creates a new one band raster formed by applying a valid PostgreSQL algebraic operation to the two bands defined by the <varname>expression</varname> on the two input raster bands <varname>rast1</varname>, (<varname>rast2</varname>). If no <varname>band1</varname>, <varname>band2</varname> is specified band 1 is assumed. The resulting raster will be aligned (scale, skew and pixel corners) on the grid defined by the first raster. The resulting raster will have the extent defined by the <varname>extenttype</varname> parameter.
fr: Crée un nouveau raster à une bande formé en appliquant une opération algébrique PostgreSQL valide aux deux bandes définies par <varname>expression</varname> sur les deux bandes d'entrée <varname>rast1</varname> (et optionnellement <varname>rast2</varname>). Si aucune bande <varname>band1</varname>, <varname>band2</varname> n'est spécifiée, la bande 1 est utilisée. Le raster résultant sera aligné (échelle, obliquité et coins) sur la grille définie par le premier raster. Le raster résultant aura l'étendue définie par le paramètre <varname>extenttype</varname>.

note: Tag: para
en: A PostgreSQL algebraic expression involving the two rasters and PostgreSQL defined functions/operators that will define the pixel value when pixels intersect. e.g. (([rast1] + [rast2])/2.0)::integer
fr: Une expression algébrique PostgreSQL impliquant les deux rasters et les fonctions/opérateurs définis par PostgreSQL qui définiront la valeur du pixel lorsque les pixels intersectent, par exemple (([rast1] + [rast2])/2.0)::integer

note: Tag: para
en: The resulting pixel type of the output raster. Must be one listed in <xref linkend="RT_ST_BandPixelType"/>, left out or set to NULL. If not passed in or set to NULL, will default to the pixeltype of the first raster.
fr: Le type de pixel résultant du raster de sortie. Doit être l'un de ceux listés dans <xref linkend="RT_ST_BandPixelType"/>, omis ou NULL. S'il n'est pas fourni ou NULL, le type de pixel du premier raster sera utilisé par défaut.

note: Tag: para
en: Controls the extent of resulting raster
fr: Contrôle l'étendue du raster de sortie

note: Tag: para
en: <varname>INTERSECTION</varname> - The extent of the new raster is the intersection of the two rasters. This is the default.
fr: <varname>INTERSECTION</varname> - L'étendue du nouveau raster est l'intersection des deux rasters. Il s'agit de la valeur par défaut.

note: Tag: para
en: <varname>UNION</varname> - The extent of the new raster is the union of the two rasters.
fr: <varname>UNION</varname> - L'étendue du nouveau raster est l'union des deux rasters.

note: Tag: para
en: <varname>FIRST</varname> - The extent of the new raster is the same as the one of the first raster.
fr: <varname>FIRST</varname> - L'étendue du nouveau raster est la même que celle du premier raster.

note: Tag: para
en: <varname>SECOND</varname> - The extent of the new raster is the same as the one of the second raster.
fr: <varname>SECOND</varname> - L'étendue du nouveau raster est la même que celle du second raster.

note: Tag: para
en: An algebraic expression involving only <varname>rast2</varname> or a constant that defines what to return when pixels of <varname>rast1</varname> are nodata values and spatially corresponding rast2 pixels have values.
fr: Une expression algébrique impliquant uniquement <varname>rast2</varname>, ou une constante qui définit la valeur à retourner lorsque les pixels de <varname>rast1</varname> sont des valeurs nodata et que les pixels correspondants dans rast2 ont des valeurs.

note: Tag: para
en: An algebraic expression involving only <varname>rast1</varname> or a constant that defines what to return when pixels of <varname>rast2</varname> are nodata values and spatially corresponding rast1 pixels have values.
fr: Une expression algébrique impliquant uniquement <varname>rast1</varname>, ou une constante qui définit la valeur à retourner lorsque les pixels de <varname>rast2</varname> sont des valeurs nodata et que les pixels correspondants dans rast1 ont des valeurs.

note: Tag: para
en: A numeric constant to return when spatially corresponding rast1 and rast2 pixels are both nodata values.
fr: Constante numérique à retourner lorsque les pixels de rast1 et de rast2 sont tous deux des valeurs nodata.

note: Tag: para
en: Keywords permitted in <varname>expression</varname>, <varname>nodata1expr</varname> and <varname>nodata2expr</varname>
fr: Mots clés possibles dans <varname>expression</varname>, <varname>nodata1expr</varname> et <varname>nodata2expr</varname>

note: Tag: para
en: <varname>[rast1]</varname> - Pixel value of the pixel of interest from <varname>rast1</varname>
fr: <varname>[rast1]</varname> - Valeur du pixel d'intérêt sur <varname>rast1</varname>

note: Tag: para
en: <varname>[rast1.val]</varname> - Pixel value of the pixel of interest from <varname>rast1</varname>
fr: <varname>[rast1.val]</varname> - Valeur du pixel d'intérêt de <varname>rast1</varname>

note: Tag: para
en: <varname>[rast1.x]</varname> - 1-based pixel column of the pixel of interest from <varname>rast1</varname>
fr: <varname>[rast1.x]</varname> - Colonne du pixel d'intérêt de <varname>rast1</varname> (démarrant à 1)

note: Tag: para
en: <varname>[rast1.y]</varname> - 1-based pixel row of the pixel of interest from <varname>rast1</varname>
fr: <varname>[rast1.y]</varname> - Ligne du pixel d'intérêt de <varname>rast1</varname> (démarrant à 1)

note: Tag: para
en: <varname>[rast2]</varname> - Pixel value of the pixel of interest from <varname>rast2</varname>
fr: <varname>[rast2]</varname> - Valeur du pixel d'intérêt sur <varname>rast2</varname>

note: Tag: para
en: <varname>[rast2.val]</varname> - Pixel value of the pixel of interest from <varname>rast2</varname>
fr: <varname>[rast2.val]</varname> - Valeur du pixel d'intérêt de <varname>rast2</varname>

note: Tag: para
en: <varname>[rast2.x]</varname> - 1-based pixel column of the pixel of interest from <varname>rast2</varname>
fr: <varname>[rast2.x]</varname> - Colonne du pixel d'intérêt de <varname>rast2</varname> (démarrant à 1)

note: Tag: para
en: <varname>[rast2.y]</varname> - 1-based pixel row of the pixel of interest from <varname>rast2</varname>
fr: <varname>[rast2.y]</varname> - Ligne du pixel d'intérêt de <varname>rast2</varname> (démarrant à 1)

note: Tag: title
en: Examples: Variants 1 and 2
fr: Exemples : Variantes 1 et 2

note: Tag: title
en: Examples: Variant 3 and 4
fr: Exemples : Variantes 3 et 4

note: Tag: refpurpose
en: 1 raster band version: Creates a new one band raster formed by applying a valid PostgreSQL algebraic operation on the input raster band and of pixeltype provided. Band 1 is assumed if no band is specified.
fr: Version avec raster à 1 bande : Crée un nouveau raster à une bande formé par l'application d'une opération algébrique PostgreSQL valide sur la bande d'entrée du raster et du type de pixel fourni. Si aucune bande n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: is deprecated as of 2.1.0. Use <xref linkend="RT_ST_MapAlgebra_expr"/> instead.
fr: est obsolète depuis 2.1.0. Utilisez plutôt <xref linkend="RT_ST_MapAlgebra_expr"/>.

note: Tag: para
en: Creates a new one band raster formed by applying a valid PostgreSQL algebraic operation defined by the <varname>expression</varname> on the input raster (<varname>rast</varname>). If no <varname>band</varname> is specified band 1 is assumed. The new raster will have the same georeference, width, and height as the original raster but will only have one band.
fr: Crée un nouveau raster à une bande formé par l'application d'une opération algébrique PostgreSQL valide définie par <varname>expression</varname> sur le raster d'entrée (<varname>rast</varname>). Si aucune <varname>band</varname> n'est spécifiée, la bande 1 est utilisée. Le nouveau raster aura la même géoréférence, la même largeur et la même hauteur que le raster original mais n'aura qu'une seule bande.

note: Tag: para
en: In the expression you can use the term <varname>[rast]</varname> to refer to the pixel value of the original band, <varname>[rast.x]</varname> to refer to the 1-based pixel column index, <varname>[rast.y]</varname> to refer to the 1-based pixel row index.
fr: Dans l'expression, vous pouvez utiliser le mot clé <varname>[rast]</varname> pour faire référence à la valeur en pixels de la bande originale, <varname>[rast.x]</varname> pour faire référence à l'indice de colonne de pixels (basé sur 1), <varname>[rast.y]</varname> pour faire référence à l'indice de ligne de pixels (basé sur 1).

note: Tag: para
en: Create a new 1 band raster from our original that is a function of modulo 2 of the original raster band.
fr: Crée une nouveau raster à 1 bande qui est une fonction modulo 2 de la bande du raster original.

note: Tag: para
en: Create a new 1 band raster of pixel-type 2BUI from our original that is reclassified and set the nodata value to be 0.
fr: Crée un nouveau raster à 1 bande de type de pixel 2BUI à partir d'un raster original reclassifié et avec la valeur nodata à 0.

note: Tag: para
en: original (column rast_view)
fr: original (colonne rast_view)

note: Tag: para
en: Create a new 3 band raster same pixel type from our original 3 band raster with first band altered by map algebra and remaining 2 bands unaltered.
fr: Crée un nouveau raster à 3 bandes de même type de pixel que le raster original à 3 bandes, la première bande étant modifiée par l'algèbre cartographique et les 2 bandes restantes n'étant pas modifiées.

note: Tag: refpurpose
en: 2 raster band version: Creates a new one band raster formed by applying a valid PostgreSQL algebraic operation on the two input raster bands and of pixeltype provided. band 1 of each raster is assumed if no band numbers are specified. The resulting raster will be aligned (scale, skew and pixel corners) on the grid defined by the first raster and have its extent defined by the "extenttype" parameter. Values for "extenttype" can be: INTERSECTION, UNION, FIRST, SECOND.
fr: Version avec 2 bandes : Crée un nouveau raster à une bande formé en appliquant une opération algébrique PostgreSQL valide sur les deux bandes du raster d'entrée et du type de pixel fourni. La bande 1 de chaque raster est utilisée si aucun numéro de bande n'est spécifié. Le raster résultant sera aligné (échelle, obliquité et coins) sur la grille définie par le premier raster et aura son étendue définie par le paramètre "extenttype". Les valeurs de "extenttype" peuvent être : INTERSECTION, UNION, FIRST, SECOND.

note: Tag: para
en: If <varname>pixeltype</varname> is passed in, then the new raster will have a band of that pixeltype. If pixeltype is passed NULL or no pixel type specified, then the new raster band will have the same pixeltype as the input <varname>rast1</varname> band.
fr: Si le <varname>pixeltype</varname> est fourni, le nouveau raster aura une bande de ce type de pixel. Si le type de pixel est NULL ou si aucun type de pixel n'est spécifié, la nouvelle bande raster aura le même type de pixel que la bande d'entrée de <varname>rast1</varname>.

note: Tag: para
en: Use the term <varname>[rast1.val]</varname> <varname>[rast2.val]</varname> to refer to the pixel value of the original raster bands and <varname>[rast1.x]</varname>, <varname>[rast1.y]</varname> etc. to refer to the column / row positions of the pixels.
fr: Utilisez le mot clé <varname>[rast1.val]</varname> <varname>[rast2.val]</varname> pour désigner la valeur en pixels des bandes raster d'origine et <varname>[rast1.x]</varname>, <varname>[rast1.y]</varname> etc. pour désigner la position des pixels dans les colonnes et les lignes.

note: Tag: title
en: Example: 2 Band Intersection and Union
fr: Exemple : Intersection et Union avec 2 bandes

note: Tag: para
en: mapalgebra intersection
fr: intersection

note: Tag: para
en: map algebra union
fr: union

note: Tag: title
en: Example: Overlaying rasters on a canvas as separate bands
fr: Exemple : Superposition de rasters sur un canevas sous forme de bandes distinctes

note: Tag: title
en: Example: Overlay 2 meter boundary of select parcels over an aerial imagery
fr: Exemple : Superposition d'une délimitation de 2 mètres de certaines parcelles sur une image aérienne

note: Tag: para
en: The blue lines are the boundaries of select parcels
fr: Les lignes bleues représentent les limites des parcelles sélectionnées

note: Tag: refpurpose
en: 1 band version - Creates a new one band raster formed by applying a valid PostgreSQL function on the input raster band and of pixeltype prodived. Band 1 is assumed if no band is specified.
fr: Version à 1 bande - Crée un nouveau raster à une bande formé par l'application d'une fonction PostgreSQL valide sur la bande d'entrée du raster et sur le type de pixel fourni. La bande 1 est utilisée si aucune bande n'est spécifiée.

note: Tag: para
en: is deprecated as of 2.1.0. Use <xref linkend="RT_ST_MapAlgebra"/> instead.
fr: est obsolète depuis 2.1.0. Utilisez plutôt <xref linkend="RT_ST_MapAlgebra"/>.

note: Tag: para
en: Creates a new one band raster formed by applying a valid PostgreSQL function specified by the <varname>onerasteruserfunc</varname> on the input raster (<varname>rast</varname>). If no <varname>band</varname> is specified, band 1 is assumed. The new raster will have the same georeference, width, and height as the original raster but will only have one band.
fr: Crée un nouveau raster à une bande formé en appliquant une fonction PostgreSQL valide spécifiée par <varname>onerasteruserfunc</varname> sur le raster d'entrée (<varname>rast</varname>). Si aucune bande <varname>band</varname> n'est spécifiée, la bande 1 est utilisée. Le nouveau raster aura la même géoréférence, la même largeur et la même hauteur que le raster original mais n'aura qu'une seule bande.

note: Tag: para
en: The third argument to the <varname>userfunction</varname> is a <type>variadic text</type> array. All trailing text arguments to any <xref linkend="RT_ST_MapAlgebraFct"/> call are passed through to the specified <varname>userfunction</varname>, and are contained in the <varname>args</varname> argument.
fr: Le troisième paramètre de la fonction <varname>userfunction</varname> est un tableau <type>variadic text</type> . Tous les arguments textuels supplémentaires de l'appel à <xref linkend="RT_ST_MapAlgebraFct"/> sont transmis à <varname>userfunction</varname>, et sont contenus dans l'argument <varname>args</varname>.

note: Tag: para
en: The <type>text[]</type> argument to the <varname>userfunction</varname> is required, regardless of whether you choose to pass any arguments to your user function for processing or not.
fr: Le paramètre <type>text[]</type> de la fonction <varname>userfunction</varname> est obligatoire, que vous choisissiez ou non de transmettre des arguments à la fonction de rappel.

note: Tag: para
en: Create a new 1 band raster of pixel-type 2BUI from our original that is reclassified and set the nodata value to a passed parameter to the user function (0).
fr: Crée un nouveau raster à 1 bande de type de pixel 2BUI à partir d'un raster reclassifié avec la valeur nodata fixée via un paramètre passé à la fonction utilisateur (0).

note: Tag: para
en: original (column rast-view)
fr: original (colonne rast-view)

note: Tag: refpurpose
en: 2 band version - Creates a new one band raster formed by applying a valid PostgreSQL function on the 2 input raster bands and of pixeltype prodived. Band 1 is assumed if no band is specified. Extent type defaults to INTERSECTION if not specified.
fr: Version à 2 bandes - Crée un nouveau raster à une bande formé par l'application d'une fonction PostgreSQL valide sur les 2 bandes d'entrée du raster et sur le type de pixel fourni. La bande 1 est utilisée si aucune bande n'est spécifiée. Le type d'étendue INTERSECTION est utilisé si non spécifié.

note: Tag: para
en: Creates a new one band raster formed by applying a valid PostgreSQL function specified by the <varname>tworastuserfunc</varname> on the input raster <varname>rast1</varname>, <varname>rast2</varname>. If no <varname>band1</varname> or <varname>band2</varname> is specified, band 1 is assumed. The new raster will have the same georeference, width, and height as the original rasters but will only have one band.
fr: Crée un nouveau raster à une bande formé par l'application d'une fonction PostgreSQL valide spécifiée par <varname>tworastuserfunc</varname> sur les rasters d'entrée <varname>rast1</varname>, <varname>rast2</varname>. Si aucune bande <varname>band1</varname> ou <varname>band2</varname> n'est spécifiée, la bande 1 est utilisée. Le nouveau raster aura la même géoréférence, la même largeur et la même hauteur que les rasters originaux, mais il n'aura qu'une seule bande.

note: Tag: para
en: If <varname>pixeltype</varname> is passed in, then the new raster will have a band of that pixeltype. If pixeltype is passed NULL or left out, then the new raster band will have the same pixeltype as the input <varname>rast1</varname> band.
fr: Si <varname>pixeltype</varname> est fourni, le nouveau raster aura une bande de ce type de pixel. Si pixeltype est NULL ou omis, la nouvelle bande raster aura le même type de pixel que la bande d'entrée de <varname>rast1</varname>.

note: Tag: para
en: The fourth argument to the <varname>tworastuserfunc</varname> is a <type>variadic text</type> array. All trailing text arguments to any <xref linkend="RT_ST_MapAlgebraFct2"/> call are passed through to the specified <varname>tworastuserfunc</varname>, and are contained in the <varname>userargs</varname> argument.
fr: Le quatrième paramètre de la fonction <varname>tworastuserfunc</varname> est un tableau <type>variadic text</type> . Tous les arguments textuels supplémentaires de l'appel à <xref linkend="RT_ST_MapAlgebraFct2"/> sont transmis à <varname>tworastuserfunc</varname>, et sont contenus dans l'argument <varname>userargs</varname>.

note: Tag: para
en: The <type>text[]</type> argument to the <varname>tworastuserfunc</varname> is required, regardless of whether you choose to pass any arguments to your user function for processing or not.
fr: Le paramètre <type>text[]</type> de la fonction <varname>tworastuserfunc</varname> est obligatoire, que vous choisissiez ou non de transmettre des arguments à la fonction de rappel.

note: Tag: para
en: map bands overlay (canvas) (R: small road, G: circle, B: big road)
fr: superposition des bandes de la carte (canevas) (R : small road, G : circle, B : big road)

note: Tag: title
en: User Defined function that takes extra args
fr: Fonction définie par l'utilisateur avec arguments supplémentaires

note: Tag: para
en: user defined with extra args and different bands from same raster
fr: Fonction définie par l'utilisateur avec arguments supplémentaires et plusieurs bandes issus du même raster

note: Tag: refpurpose
en: 1-band version: Map Algebra Nearest Neighbor using user-defined PostgreSQL function. Return a raster which values are the result of a PLPGSQL user function involving a neighborhood of values from the input raster band.
fr: Version à 1 bande : Algèbre cartographique Plus proche voisin en utilisant une fonction PostgreSQL définie par l'utilisateur. Retourne un raster dont les valeurs sont le résultat d'une fonction utilisateur PLPGSQL prenant un voisinage des valeurs de la bande raster d'entrée.

note: Tag: para
en: (one raster version) Return a raster which values are the result of a PLPGSQL user function involving a neighborhood of values from the input raster band. The user function takes the neighborhood of pixel values as an array of numbers, for each pixel, returns the result from the user function, replacing pixel value of currently inspected pixel with the function result.
fr: (version à un raster) Retourne un raster dont les valeurs sont le résultat d'une fonction utilisateur PLPGSQL prenant un voisinage de valeurs de la bande du raster d'entrée. La fonction utilisateur prend le voisinage des valeurs des pixels sous la forme d'un tableau de nombres. Pour chaque pixel, elle renvoie le résultat de la fonction utilisateur, en remplaçant la valeur du pixel actuellement traité par le résultat de la fonction utilisateur.

note: Tag: para
en: Raster on which the user function is evaluated.
fr: Raster sur lequel la fonction utilisateur est évaluée.

note: Tag: para
en: Band number of the raster to be evaluated. Default to 1.
fr: Numéro de bande du raster à évaluer. La valeur par défaut est 1.

note: Tag: para
en: The resulting pixel type of the output raster. Must be one listed in <xref linkend="RT_ST_BandPixelType"/> or left out or set to NULL. If not passed in or set to NULL, will default to the pixeltype of the <varname>rast</varname>. Results are truncated if they are larger than what is allowed for the pixeltype.
fr: Le type de pixel résultant du raster de sortie. Doit être l'un de ceux listés dans <xref linkend="RT_ST_BandPixelType"/>, ou être omis ou défini à NULL. S'il n'est pas spécifié ou s'il est défini à NULL, le type de pixel du raster <varname>rast</varname> sera utilisé par défaut. Les résultats sont tronqués s'ils sont plus grands que ce qui est autorisé pour le type de pixel.

note: Tag: para
en: The width of the neighborhood, in cells.
fr: La largeur du voisinage, en nombre de cellules.

note: Tag: para
en: The height of the neighborhood, in cells.
fr: La hauteur du voisinage, en nombre de cellules.

note: Tag: para
en: PLPGSQL/psql user function to apply to neighborhood pixels of a single band of a raster. The first element is a 2-dimensional array of numbers representing the rectangular pixel neighborhood
fr: Fonction utilisateur PLPGSQL/psql à appliquer aux pixels du voisinage de la bande du raster. Le premier élément est un tableau bidimensionnel de nombres, représentant le voisinage rectangulaire du pixel

note: Tag: para
en: Defines what value to pass to the function for a neighborhood pixel that is nodata or NULL
fr: Définit la valeur à transmettre à la fonction pour un pixel de voisinage qui est nodata ou NULL

note: Tag: para
en: 'ignore': any NODATA values encountered in the neighborhood are ignored by the computation -- this flag must be sent to the user callback function, and the user function decides how to ignore it.
fr: 'ignore' : toutes les valeurs NODATA rencontrées dans le voisinage sont ignorées par le calcul -- ce drapeau doit être envoyé à la fonction de rappel de l'utilisateur, et c'est la fonction de l'utilisateur qui décide comment l'ignorer.

note: Tag: para
en: 'NULL': any NODATA values encountered in the neighborhood will cause the resulting pixel to be NULL -- the user callback function is skipped in this case.
fr: 'NULL' : toute valeur NODATA rencontrée dans le voisinage aura pour conséquence que le pixel résultant sera NULL -- la fonction de rappel de l'utilisateur est ignorée dans ce cas.

note: Tag: para
en: 'value': any NODATA values encountered in the neighborhood are replaced by the reference pixel (the one in the center of the neighborhood). Note that if this value is NODATA, the behavior is the same as 'NULL' (for the affected neighborhood)
fr: 'value' : toutes les valeurs NODATA rencontrées dans le voisinage sont remplacées par le pixel de référence (celui qui se trouve au centre du voisinage). Notez que si cette valeur est NODATA, le comportement est le même que 'NULL' (pour le voisinage concerné)

note: Tag: para
en: Arguments to pass into the user function.
fr: Arguments à transmettre à la fonction utilisateur.

note: Tag: para
en: Examples utilize the katrina raster loaded as a single tile described in <ulink url="http://trac.osgeo.org/gdal/wiki/frmts_wtkraster.html">http://trac.osgeo.org/gdal/wiki/frmts_wtkraster.html</ulink> and then prepared in the <xref linkend="RT_ST_Rescale"/> examples
fr: Les exemples utilisent le raster katrina chargé comme une seule tuile, tel que décrit dans <ulink url="http://trac.osgeo.org/gdal/wiki/frmts_wtkraster.html">http://trac.osgeo.org/gdal/wiki/frmts_wtkraster.html</ulink> et ensuite traitée dans les exemples <xref linkend="RT_ST_Rescale"/>

note: Tag: para
en: First band of our raster
fr: Première bande du raster

note: Tag: para
en: new raster after averaging pixels withing 4x4 pixels of each other
fr: nouveau raster après calcul de la moyenne des pixels situés à moins de 4x4 pixels les uns des autres

note: Tag: refpurpose
en: Creates a new raster composed of band types reclassified from original. The nband is the band to be changed. If nband is not specified assumed to be 1. All other bands are returned unchanged. Use case: convert a 16BUI band to a 8BUI and so forth for simpler rendering as viewable formats.
fr: Crée un nouveau raster composé de types de bandes reclassifiés par rapport à l'original. La bande n est la bande à modifier. Si nband n'est pas spécifié, la bande 1 est utilisée. Toutes les autres bandes sont retournées inchangées. Cas d'utilisation : convertir une bande 16BUI en 8BUI et ainsi de suite pour un rendu plus simple en tant que formats visualisables.

note: Tag: para
en: Creates a new raster formed by applying a valid PostgreSQL algebraic operation defined by the <varname>reclassexpr</varname> on the input raster (<varname>rast</varname>). If no <varname>band</varname> is specified band 1 is assumed. The new raster will have the same georeference, width, and height as the original raster. Bands not designated will come back unchanged. Refer to <xref linkend="reclassarg"/> for description of valid reclassification expressions.
fr: Crée un nouveau raster formé par l'application d'une opération algébrique PostgreSQL valide définie par <varname>reclassexpr</varname> sur le raster d'entrée (<varname>rast</varname>). Si aucune bande <varname>band</varname> n'est spécifiée, la bande 1 est utilisée. Le nouveau raster aura la même géoréférence, la même largeur et la même hauteur que le raster original. Les bandes non désignées seront retournées inchangées. Voir <xref linkend="reclassarg"/> pour la description des expressions de reclassification valides.

note: Tag: para
en: The bands of the new raster will have pixel type of <varname>pixeltype</varname>. If <varname>reclassargset</varname> is passed in then each reclassarg defines behavior of each band generated.
fr: Les bandes du nouveau raster auront le type de pixel <varname>pixeltype</varname>. Si <varname>reclassargset</varname> est spécifié, chaque reclassarg définit le comportement de chaque bande générée.

note: Tag: para
en: Create a new raster from the original where band 2 is converted from 8BUI to 4BUI and all values from 101-254 are set to nodata value.
fr: Crée un nouveau raster à partir de l'original où la bande 2 est convertie de 8BUI à 4BUI et où toutes les valeurs entre 101 et 254 sont fixées à nodata.

note: Tag: title
en: Example: Advanced using multiple reclassargs
fr: Exemple avancé : utiliser plusieurs reclassargs

note: Tag: para
en: Create a new raster from the original where band 1,2,3 is converted to 1BB,4BUI, 4BUI respectively and reclassified. Note this uses the variadic <varname>reclassarg</varname> argument which can take as input an indefinite number of reclassargs (theoretically as many bands as you have)
fr: Crée un nouveau raster à partir de l'original où les bandes 1, 2, 3 sont respectivement converties en 1BB, 4BUI, 4BUI et reclassifiées. Cette opération utilise l'argument variadique <varname>reclassarg</varname> qui peut prendre en entrée un nombre variable de reclassargs (théoriquement autant de bandes que vous avez)

note: Tag: title
en: Example: Advanced Map a single band 32BF raster to multiple viewable bands
fr: Exemple avancé : Mapping d'un raster 32BF à bande unique en plusieurs bandes visualisables

note: Tag: para
en: Create a new 3 band (8BUI,8BUI,8BUI viewable raster) from a raster that has only one 32bf band
fr: Crée un nouveau raster à 3 bandes (8BUI, 8BUI, 8BUI visualisable) à partir d'un raster qui n'a qu'une seule bande de 32bf

note: Tag: refpurpose
en: Returns the union of a set of raster tiles into a single raster composed of 1 or more bands.
fr: Retourne l'union d'un ensemble de tuiles raster, en un seul raster composé de 1 ou plusieurs bandes.

note: Tag: para
en: Returns the union of a set of raster tiles into a single raster composed of at least one band. The resulting raster's extent is the extent of the whole set. In the case of intersection, the resulting value is defined by <varname>uniontype</varname> which is one of the following: LAST (default), FIRST, MIN, MAX, COUNT, SUM, MEAN, RANGE.
fr: Retourne l'union d'un ensemble de tuiles raster en un seul raster, composé d'au moins une bande. L'étendue du raster résultant est l'étendue de l'ensemble. Dans le cas d'une intersection, la valeur résultante est définie par <varname>uniontype</varname> parmi : LAST (par défaut), FIRST, MIN, MAX, COUNT, SUM, MEAN, RANGE.

note: Tag: para
en: In order for rasters to be unioned, they must all have the same alignment. Use <xref linkend="RT_ST_SameAlignment"/> and <xref linkend="RT_ST_NotSameAlignmentReason"/> for more details and help. One way to fix alignment issues is to use <xref linkend="RT_ST_Resample"/> and use the same reference raster for alignment.
fr: Pour pouvoir calculer l'union de raster, tous les rasters doivent avoir le même alignement. Voir <xref linkend="RT_ST_SameAlignment"/> et <xref linkend="RT_ST_NotSameAlignmentReason"/> pour plus de détails. Une façon de résoudre les problèmes d'alignement est d'utiliser <xref linkend="RT_ST_Resample"/> et d'utiliser le même raster de référence pour l'alignement.

note: Tag: para
en: Enhanced: 2.1.0 Improved Speed (fully C-Based).
fr: Amélioration : 2.1.0 Vitesse améliorée (entièrement en C).

note: Tag: para
en: Availability: 2.1.0 ST_Union(rast, unionarg) variant was introduced.
fr: Disponibilité : 2.1.0 Ajout de la variante ST_Union(rast, unionarg).

note: Tag: para
en: Enhanced: 2.1.0 ST_Union(rast) (variant 1) unions all bands of all input rasters. Prior versions of PostGIS assumed the first band.
fr: Amélioration : 2.1.0 ST_Union(rast) (variante 1) permet l'union sur toutes les bandes de tous les rasters d'entrée. Les versions précédentes de PostGIS ne prenaient en compte que la première bande.

note: Tag: para
en: Enhanced: 2.1.0 ST_Union(rast, uniontype) (variant 4) unions all bands of all input rasters.
fr: Amélioration : 2.1.0 ST_Union(rast, uniontype) (variante 4) permet l'union de toutes les bandes de tous les rasters d'entrée.

note: Tag: title
en: Examples: Reconstitute a single band chunked raster tile
fr: Exemples : Reconstituer une tuile raster à partir d'une tuile raster fragmentée d'une seule bande

note: Tag: title
en: Examples: Return a multi-band raster that is the union of tiles intersecting geometry
fr: Exemples : Retourne un raster multi-bandes qui est l'union de tuiles intersectant une géométrie

note: Tag: para
en: Here we use the longer syntax if we only wanted a subset of bands or we want to change order of bands
fr: Nous utilisons ici la syntaxe plus longue si nous ne voulons qu'un sous-ensemble de bandes ou si nous voulons changer l'ordre des bandes

note: Tag: title
en: Built-in Map Algebra Callback Functions
fr: Fonctions de rappel intégrées d'algèbre cartographique

note: Tag: refpurpose
en: Raster processing function that calculates the number of unique pixel values in a neighborhood.
fr: Fonction de traitement des données raster qui calcule le nombre de valeurs de pixels uniques dans un voisinage.

note: Tag: para
en: Calculate the number of unique pixel values in a neighborhood of pixels.
fr: Calcule le nombre de valeurs de pixels uniques dans un voisinage de pixels.

note: Tag: para
en: Variant 1 is a specialized callback function for use as a callback parameter to <xref linkend="RT_ST_MapAlgebraFctNgb"/>.
fr: La variante 1 est une fonction de rappel spécialisée à utiliser comme paramètre de rappel pour <xref linkend="RT_ST_MapAlgebraFctNgb"/>.

note: Tag: para
en: Variant 2 is a specialized callback function for use as a callback parameter to <xref linkend="RT_ST_MapAlgebra"/>.
fr: La variante 2 est une fonction de rappel spécialisée à utiliser comme paramètre de rappel pour <xref linkend="RT_ST_MapAlgebra"/>.

note: Tag: para
en: Use of Variant 1 is discouraged since <xref linkend="RT_ST_MapAlgebraFctNgb"/> has been deprecated as of 2.1.0.
fr: L'utilisation de la variante 1 est non recommandée, <xref linkend="RT_ST_MapAlgebraFctNgb"/> étant dépréciée depuis 2.1.0.

note: Tag: para
en: Enhanced: 2.1.0 Addition of Variant 2
fr: Amélioration : 2.1.0 Ajout de la variante 2

note: Tag: refpurpose
en: Raster processing function that interpolates a pixel's value from the pixel's neighborhood.
fr: Fonction de traitement des données raster qui interpole la valeur d'un pixel à partir de son voisinage.

note: Tag: para
en: Calculate an interpolated value for a pixel using the Inverse Distance Weighted method.
fr: Calcule une valeur interpolée pour un pixel en utilisant la méthode de la distance inverse pondérée.

note: Tag: para
en: There are two optional parameters that can be passed through <varname>userargs</varname>. The first parameter is the power factor (variable k in the equation below) between 0 and 1 used in the Inverse Distance Weighted equation. If not specified, default value is 1. The second parameter is the weight percentage applied only when the value of the pixel of interest is included with the interpolated value from the neighborhood. If not specified and the pixel of interest has a value, that value is returned.
fr: Deux paramètres facultatifs peuvent être fournis par l'intermédiaire de <varname>userargs</varname>. Le premier paramètre est le facteur de puissance (variable k dans l'équation ci-dessous) entre 0 et 1, utilisé dans l'équation de la pondération de la distance inverse. S'il n'est pas spécifié, la valeur par défaut est 1. Le second paramètre est le pourcentage de pondération, appliqué uniquement lorsque la valeur du pixel d'intérêt est incluse dans la valeur interpolée du voisinage. S'il n'est pas spécifié et que le pixel d'intérêt a une valeur, cette valeur est retournée.

note: Tag: para
en: The basic inverse distance weight equation is:
fr: L'équation de base de la distance inverse pondérée est :

note: Tag: para
en: k = power factor, a real number between 0 and 1
fr: k = facteur de puissance, un nombre réel entre 0 et 1

note: Tag: para
en: This function is a specialized callback function for use as a callback parameter to <xref linkend="RT_ST_MapAlgebra"/>.
fr: Cette fonction est une fonction de rappel spécialisée à utiliser comme paramètre de rappel pour <xref linkend="RT_ST_MapAlgebra"/>.

note: Tag: refpurpose
en: Raster processing function that calculates the maximum pixel value in a neighborhood.
fr: Fonction de traitement des données raster qui calcule la valeur maximale d'un pixel dans un voisinage.

note: Tag: para
en: Calculate the maximum pixel value in a neighborhood of pixels.
fr: Calcule la valeur maximale d'un pixel dans un voisinage de pixels.

note: Tag: para
en: For Variant 2, a substitution value for NODATA pixels can be specified by passing that value to userargs.
fr: Pour la variante 2, une valeur de substitution pour les pixels NODATA peut être spécifiée en passant cette valeur à userargs.

note: Tag: refpurpose
en: Raster processing function that calculates the mean pixel value in a neighborhood.
fr: Fonction de traitement des données raster qui calcule la valeur moyenne d'un pixel dans un voisinage.

note: Tag: para
en: Calculate the mean pixel value in a neighborhood of pixels.
fr: Calcule la valeur moyenne d'un pixel dans un voisinage de pixels.

note: Tag: refpurpose
en: Raster processing function that calculates the minimum pixel value in a neighborhood.
fr: Fonction de traitement des données raster qui calcule la valeur minimale d'un pixel dans un voisinage.

note: Tag: para
en: Calculate the minimum pixel value in a neighborhood of pixels.
fr: Calcule la valeur minimale d'un pixel dans un voisinage de pixels.

note: Tag: refpurpose
en: Raster processing function that returns the minimum distance (in number of pixels) between the pixel of interest and a neighboring pixel with value.
fr: Fonction de traitement des données raster qui renvoie la distance minimale (en nombre de pixels) entre le pixel d'intérêt et un pixel voisin ayant une valeur.

note: Tag: para
en: Return the shortest distance (in number of pixels) between the pixel of interest and the closest pixel with value in the neighborhood.
fr: Retourne la plus petite distance (en nombre de pixels) entre le pixel d'intérêt et le pixel le plus proche ayant une valeur dans le voisinage.

note: Tag: para
en: The intent of this function is to provide an informative data point that helps infer the usefulness of the pixel of interest's interpolated value from <xref linkend="RT_ST_InvDistWeight4ma"/>. This function is particularly useful when the neighborhood is sparsely populated.
fr: Le but de cette fonction est de fournir un point de données informatif qui aide à déduire l'utilité de la valeur interpolée du pixel d'intérêt à partir de <xref linkend="RT_ST_InvDistWeight4ma"/>. Cette fonction est particulièrement utile lorsque le voisinage est peu peuplé.

note: Tag: refpurpose
en: Raster processing function that calculates the range of pixel values in a neighborhood.
fr: Fonction de traitement des données raster qui calcule la plage de valeurs des pixels dans un voisinage.

note: Tag: para
en: Calculate the range of pixel values in a neighborhood of pixels.
fr: Calcule la plage de valeurs des pixels dans un voisinage de pixels.

note: Tag: refpurpose
en: Raster processing function that calculates the standard deviation of pixel values in a neighborhood.
fr: Fonction de traitement des données raster qui calcule l'écart type des valeurs des pixels dans un voisinage.

note: Tag: para
en: Calculate the standard deviation of pixel values in a neighborhood of pixels.
fr: Calcule l'écart type des valeurs des pixels dans un voisinage de pixels.

note: Tag: refpurpose
en: Raster processing function that calculates the sum of all pixel values in a neighborhood.
fr: Fonction de traitement des données raster qui calcule la somme de toutes les valeurs de pixels dans un voisinage.

note: Tag: para
en: Calculate the sum of all pixel values in a neighborhood of pixels.
fr: Calcule la somme de toutes les valeurs des pixels dans un voisinage de pixels.

note: Tag: title
en: Raster Processing: DEM (Elevation)
fr: Traitement des données raster : MNT (élévation)

note: Tag: refpurpose
en: Returns the aspect (in degrees by default) of an elevation raster band. Useful for analyzing terrain.
fr: Retourne l'exposition (par défaut, en degrés) d'une bande raster d'élévation. Utile pour l'analyse de terrain.

note: Tag: para
en: Returns the aspect (in degrees by default) of an elevation raster band. Utilizes map algebra and applies the aspect equation to neighboring pixels.
fr: Retourne l'exposition (par défaut, en degrés) d'une bande raster d'élévation. Utilise l'algèbre cartographique et applique l'équation d'exposition aux pixels voisins.

note: Tag: para
en: <varname>units</varname> indicates the units of the aspect. Possible values are: RADIANS, DEGREES (default).
fr: <varname>units</varname> indique l'unité de l'exposition. Les valeurs possibles sont : RADIANS, DEGREES (par défaut).

note: Tag: para
en: When <varname>units</varname> = RADIANS, values are between 0 and 2 * pi radians measured clockwise from North.
fr: Lorsque <varname>units</varname> = RADIANS, les valeurs sont comprises entre 0 et 2 * pi radians, mesurés dans le sens des aiguilles d'une montre à partir du nord.

note: Tag: para
en: When <varname>units</varname> = DEGREES, values are between 0 and 360 degrees measured clockwise from North.
fr: Lorsque <varname>units</varname> = DEGREES, les valeurs sont comprises entre 0 et 360 degrés, mesurés dans le sens des aiguilles d'une montre à partir du nord.

note: Tag: para
en: If slope of pixel is zero, aspect of pixel is -1.
fr: Si la pente du pixel est nulle, l'exposition du pixel est -1.

note: Tag: para
en: For more information about Slope, Aspect and Hillshade, please refer to <ulink url="http://webhelp.esri.com/arcgisdesktop/9.3/index.cfm?TopicName=How%20Hillshade%20works">ESRI - How hillshade works</ulink> and <ulink url="http://e2b.erdas.com/fieldguide/wwhelp/wwhimpl/common/html/wwhelp.htm?context=FieldGuide&amp;file=Aspect_Images.html">ERDAS Field Guide - Aspect Images</ulink>.
fr: Pour plus d'informations sur la pente, l'exposition et l'ombrage, veuillez consulter <ulink url="http://webhelp.esri.com/arcgisdesktop/9.3/index.cfm?TopicName=How%20Hillshade%20works">ESRI - How hillshade works</ulink> et <ulink url="http://e2b.erdas.com/fieldguide/wwhelp/wwhimpl/common/html/wwhelp.htm?context=FieldGuide&amp;file=Aspect_Images.html">ERDAS Field Guide - Aspect Images</ulink>.

note: Tag: para
en: Enhanced: 2.1.0 Uses ST_MapAlgebra() and added optional <varname>interpolate_nodata</varname> function parameter
fr: Amélioration : 2.1.0 Utilise ST_MapAlgebra() et ajout du paramètre optionnel <varname>interpolate_nodata</varname>

note: Tag: para
en: Changed: 2.1.0 In prior versions, return values were in radians. Now, return values default to degrees
fr: Changement : 2.1.0 Dans les versions précédentes, les valeurs retournées étaient en radians. Désormais, les valeurs retournées sont par défaut en degrés

note: Tag: para
en: Complete example of tiles of a coverage. This query only works with PostgreSQL 9.1 or higher.
fr: Exemple complet avec les tuiles d'une couverture. Cette requête ne fonctionne qu'avec PostgreSQL 9.1 ou plus.

note: Tag: refpurpose
en: Returns the hypothetical illumination of an elevation raster band using provided azimuth, altitude, brightness and scale inputs.
fr: Retourne l'hypothétique éclairage d'une bande raster d'élévation en utilisant les valeurs d'azimut, d'altitude, de luminosité et d'échelle fournies.

note: Tag: para
en: Returns the hypothetical illumination of an elevation raster band using the azimuth, altitude, brightness, and scale inputs. Utilizes map algebra and applies the hill shade equation to neighboring pixels. Return pixel values are between 0 and 255.
fr: Retourne l'hypothétique éclairage d'une bande raster d'élévation en utilisant les données d'entrée d'azimut, d'altitude, de luminosité et d'échelle. Utilise l'algèbre cartographique et applique l'équation d'ombrage aux pixels voisins. Les valeurs des pixels retournées sont comprises entre 0 et 255.

note: Tag: para
en: <varname>azimuth</varname> is a value between 0 and 360 degrees measured clockwise from North.
fr: <varname>azimuth</varname> est une valeur comprise entre 0 et 360 degrés, mesurée dans le sens des aiguilles d'une montre à partir du nord.

note: Tag: para
en: <varname>altitude</varname> is a value between 0 and 90 degrees where 0 degrees is at the horizon and 90 degrees is directly overhead.
fr: <varname>altitude</varname> est une valeur comprise entre 0 et 90 degrés, où 0 degré correspond à l'horizon et 90 degrés à la verticale.

note: Tag: para
en: <varname>max_bright</varname> is a value between 0 and 255 with 0 as no brightness and 255 as max brightness.
fr: <varname>max_bright</varname> est une valeur comprise entre 0 et 255, 0 correspondant à une absence de luminosité et 255 à une luminosité maximale.

note: Tag: para
en: <varname>scale</varname> is the ratio of vertical units to horizontal. For Feet:LatLon use scale=370400, for Meters:LatLon use scale=111120.
fr: <varname>scale</varname> est le rapport entre les unités verticales et les unités horizontales. Pour Feet:LatLon, utiliser scale=370400, pour Meters:LatLon utiliser scale=111120.

note: Tag: para
en: If <varname>interpolate_nodata</varname> is TRUE, values for NODATA pixels from the input raster will be interpolated using <xref linkend="RT_ST_InvDistWeight4ma"/> before computing the hillshade illumination.
fr: Si <varname>interpolate_nodata</varname> est TRUE, les valeurs des pixels NODATA du raster d'entrée seront interpolées à l'aide de <xref linkend="RT_ST_InvDistWeight4ma"/> avant de calculer l'éclairage.

note: Tag: para
en: For more information about Hillshade, please refer to <ulink url="http://webhelp.esri.com/arcgisdesktop/9.3/index.cfm?TopicName=How%20Hillshade%20works">How hillshade works</ulink>.
fr: Pour plus d'informations sur l'ombrage, veuillez consulter <ulink url="http://webhelp.esri.com/arcgisdesktop/9.3/index.cfm?TopicName=How%20Hillshade%20works">How hillshade works</ulink>.

note: Tag: para
en: Changed: 2.1.0 In prior versions, azimuth and altitude were expressed in radians. Now, azimuth and altitude are expressed in degrees
fr: Changement : 2.1.0 Dans les versions précédentes, l'azimut et l'altitude étaient exprimés en radians. Désormais, l'azimut et l'altitude sont exprimés en degrés

note: Tag: refpurpose
en: Returns a raster with the calculated "roughness" of a DEM.
fr: Retourne un raster avec la rugosité d'un MNT.

note: Tag: para
en: Calculates the "roughness" of a DEM, by subtracting the maximum from the minimum for a given area.
fr: Calcule la rugosité d'un MNT en soustrayant le maximum du minimum pour une zone donnée.

note: Tag: refpurpose
en: Returns the slope (in degrees by default) of an elevation raster band. Useful for analyzing terrain.
fr: Retourne la pente (par défaut, en degrés) d'une bande raster d'élévation. Utile pour l'analyse de terrain.

note: Tag: para
en: Returns the slope (in degrees by default) of an elevation raster band. Utilizes map algebra and applies the slope equation to neighboring pixels.
fr: Retourne la pente (par défaut, en degrés) d'une bande raster d'élévation. Utilise l'algèbre cartographique et applique l'équation de pente aux pixels voisins.

note: Tag: para
en: <varname>units</varname> indicates the units of the slope. Possible values are: RADIANS, DEGREES (default), PERCENT.
fr: <varname>units</varname> indique l'unité de la pente. Les valeurs possibles sont : RADIANS, DEGREES (par défaut), PERCENT.

note: Tag: para
en: If <varname>interpolate_nodata</varname> is TRUE, values for NODATA pixels from the input raster will be interpolated using <xref linkend="RT_ST_InvDistWeight4ma"/> before computing the surface slope.
fr: Si <varname>interpolate_nodata</varname> est TRUE, les valeurs des pixels NODATA du raster d'entrée seront interpolées à l'aide de <xref linkend="RT_ST_InvDistWeight4ma"/> avant de calculer la pente de la surface.

note: Tag: para
en: For more information about Slope, Aspect and Hillshade, please refer to <ulink url="http://webhelp.esri.com/arcgisdesktop/9.3/index.cfm?TopicName=How%20Hillshade%20works">ESRI - How hillshade works</ulink> and <ulink url="http://e2b.erdas.com/fieldguide/wwhelp/wwhimpl/common/html/wwhelp.htm?context=FieldGuide&amp;file=Slope_Images.html">ERDAS Field Guide - Slope Images</ulink>.
fr: Pour plus d'informations sur la pente, l'exposition et l'ombrage, veuillez consulter <ulink url="http://webhelp.esri.com/arcgisdesktop/9.3/index.cfm?TopicName=How%20Hillshade%20works">ESRI - How hillshade works</ulink> et <ulink url="http://e2b.erdas.com/fieldguide/wwhelp/wwhimpl/common/html/wwhelp.htm?context=FieldGuide&amp;file=Slope_Images.html">ERDAS Field Guide - Slope Images</ulink>.

note: Tag: para
en: Enhanced: 2.1.0 Uses ST_MapAlgebra() and added optional <varname>units</varname>, <varname>scale</varname>, <varname>interpolate_nodata</varname> function parameters
fr: Amélioration : 2.1.0 Utilise ST_MapAlgebra() et ajout des paramètres optionnels <varname>units</varname>, <varname>scale</varname>, <varname>interpolate_nodata</varname>

note: Tag: refpurpose
en: Returns a raster with the calculated Topographic Position Index.
fr: Retourne un raster avec l'index de position topographique (TPI) calculé.

note: Tag: para
en: Calculates the Topographic Position Index, which is defined as the focal mean with radius of one minus the center cell.
fr: Calcule l'index de position topographique (TPI), qui est défini comme la moyenne focale avec un rayon de un moins la cellule centrale.

note: Tag: para
en: This function only supports a focalmean radius of one.
fr: Cette fonction ne prend en charge qu'un rayon focal de un.

note: Tag: refpurpose
en: Returns a raster with the calculated Terrain Ruggedness Index.
fr: Retourne un raster avec l'indice de rugosité du terrain (TRI) calculé.

note: Tag: para
en: Terrain Ruggedness Index is calculated by comparing a central pixel with its neighbors, taking the absolute values of the differences, and averaging the result.
fr: L'indice de rugosité du terrain est calculé en comparant le pixel central à ses voisins, en prenant les valeurs absolues des différences et en faisant la moyenne du résultat.

note: Tag: title
en: Raster Processing: Raster to Geometry
fr: Traitement des données raster : raster vers géométrie

note: Tag: refpurpose
en: Returns the box 3d representation of the enclosing box of the raster.
fr: Retourne la représentation 3d de la boîte englobante du raster.

note: Tag: para
en: Returns the box representing the extent of the raster.
fr: Retourne la boîte représentant l'étendue du raster.

note: Tag: para
en: The polygon is defined by the corner points of the bounding box ((<varname>MINX</varname>, <varname>MINY</varname>), (<varname>MAXX</varname>, <varname>MAXY</varname>))
fr: Le polygone est défini par les points des coins de la boîte englobante ((<varname>MINX</varname>, <varname>MINY</varname>), (<varname>MAXX</varname>, <varname>MAXY</varname>))

note: Tag: para
en: Changed: 2.0.0 In pre-2.0 versions, there used to be a box2d instead of box3d. Since box2d is a deprecated type, this was changed to box3d.
fr: Changement : 2.0.0 Dans les versions antérieures à la version 2.0, utilisait le type box2d au lieu de box3d. Comme box2d est un type obsolète, il a été remplacé par box3d.

note: Tag: refpurpose
en: Return the convex hull geometry of the raster including pixel values equal to BandNoDataValue. For regular shaped and non-skewed rasters, this gives the same result as ST_Envelope so only useful for irregularly shaped or skewed rasters.
fr: Retourne l'enveloppe convexe du raster, en incluant les valeurs de pixels égales à BandNoDataValue. Pour les données raster de forme régulière et sans obliquité, cette fonction donne le même résultat que ST_Envelope ; elle n'est donc utile que pour les données raster de forme irrégulière ou inclinée.

note: Tag: para
en: Return the convex hull geometry of the raster including the NoDataBandValue band pixels. For regular shaped and non-skewed rasters, this gives more or less the same result as ST_Envelope so only useful for irregularly shaped or skewed rasters.
fr: Retourne l'enveloppe convexe du raster, en incluant les valeurs de pixels égales à BandNoDataValue. Pour les données raster de forme régulière et sans obliquité, cette fonction donne plus ou moins le même résultat que ST_Envelope ; elle n'est donc utile que pour les données raster de forme irrégulière ou inclinée.

note: Tag: para
en: ST_Envelope floors the coordinates and hence add a little buffer around the raster so the answer is subtly different from ST_ConvexHull which does not floor.
fr: ST_Envelope arrondit les coordonnées à l'inférieur, et ajoute donc un petit tampon autour du raster. La réponse est donc subtilement différente de ST_ConvexHull qui n'arrondit pas les coordonnées.

note: Tag: para
en: Refer to <ulink url="http://trac.osgeo.org/postgis/wiki/WKTRaster/SpecificationWorking01">PostGIS Raster Specification</ulink> for a diagram of this.
fr: Voir <ulink url="http://trac.osgeo.org/postgis/wiki/WKTRaster/SpecificationWorking01">PostGIS Raster Specification</ulink> pour un diagramme de ceci.

note: Tag: refpurpose
en: Returns a set of geomval (geom,val) rows, from a given raster band. If no band number is specified, band num defaults to 1.
fr: Retourne un ensemble d'enregistrements de type geomval (geom, val), à partir d'une bande raster donnée. Si aucune bande bandnum n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: This is a set-returning function (SRF). It returns a set of geomval rows, formed by a geometry (geom) and a pixel band value (val). Each polygon is the union of all pixels for that band that have the same pixel value denoted by val.
fr: Il s'agit d'une fonction de retour d'ensemble (SRF). Elle retourne un ensemble d'enregistrements geomval, composés par une géométrie (geom) et une valeur de bande de pixels (val). Chaque polygone est l'union de tous les pixels de cette bande qui ont la même valeur de pixel, indiquée par val.

note: Tag: para
en: ST_DumpAsPolygon is useful for polygonizing rasters. It is the reverse of a GROUP BY in that it creates new rows. For example it can be used to expand a single raster into multiple POLYGONS/MULTIPOLYGONS.
fr: ST_DumpAsPolygon est utile pour polygoniser les données raster. C'est l'inverse d'un GROUP BY, en ce sens qu'elle crée de nouvelles lignes. Par exemple, cette fonction peut être utilisée pour décomposer un seul raster en plusieurs POLYGONS/MULTIPOLYGONS.

note: Tag: para
en: Changed 3.3.0, validation and fixing is disabled to improve performance. May result invalid geometries.
fr: Changement 3.3.0, la validation et la correction sont désactivées pour améliorer les performances. Peut donc retourner des géométries non valides.

note: Tag: para
en: Availability: Requires GDAL 1.7 or higher.
fr: Disponibilité : Nécessite GDAL 1.7 ou plus.

note: Tag: para
en: If there is a no data value set for a band, pixels with that value will not be returned except in the case of exclude_nodata_value=false.
fr: Si une valeur nodata est définie pour une bande, les pixels ayant cette valeur ne seront pas retournés, sauf si exclude_nodata_value=false.

note: Tag: para
en: If you only care about count of pixels with a given value in a raster, it is faster to use <xref linkend="RT_ST_ValueCount"/>.
fr: Si vous ne voulez que le nombre de pixels ayant une valeur donnée dans un raster, il est plus rapide d'utiliser <xref linkend="RT_ST_ValueCount"/>.

note: Tag: para
en: This is different than ST_PixelAsPolygons where one geometry is returned for each pixel regardless of pixel value.
fr: Cette fonction est différente de ST_PixelAsPolygons, où une géométrie est retournée pour chaque pixel, quelle que soit la valeur du pixel.

note: Tag: refpurpose
en: Returns the polygon representation of the extent of the raster.
fr: Retourne la représentation polygonale de l'étendue du raster.

note: Tag: para
en: Returns the polygon representation of the extent of the raster in spatial coordinate units defined by srid. It is a float8 minimum bounding box represented as a polygon.
fr: Retourne la représentation polygonale de l'étendue du raster, dans les unités du système de référence spatial défini par srid. Il s'agit d'une boîte de délimitation minimale float8 représentée sous la forme d'un polygone.

note: Tag: para
en: The polygon is defined by the corner points of the bounding box ((<varname>MINX</varname>, <varname>MINY</varname>), (<varname>MINX</varname>, <varname>MAXY</varname>), (<varname>MAXX</varname>, <varname>MAXY</varname>), (<varname>MAXX</varname>, <varname>MINY</varname>), (<varname>MINX</varname>, <varname>MINY</varname>))
fr: Le polygone est défini par les points des coins de la boîte englobante ((<varname>MINX</varname>, <varname>MINY</varname>), (<varname>MINX</varname>, <varname>MAXY</varname>), (<varname>MAXX</varname>, <varname>MAXY</varname>), (<varname>MAXX</varname>, <varname>MINY</varname>), (<varname>MINX</varname>, <varname>MINY</varname>))

note: Tag: refpurpose
en: Return the convex hull geometry of the raster excluding NODATA pixels.
fr: Retourne la géométrie de l'enveloppe convexe du raster en excluant les pixels NODATA.

note: Tag: para
en: Return the convex hull geometry of the raster excluding NODATA pixels. If <varname>nband</varname> is NULL, all bands of the raster are considered.
fr: Retourne la géométrie de l'enveloppe convexe du raster en excluant les pixels NODATA. Si <varname>nband</varname> est NULL, toutes les bandes du raster sont prises en compte.

note: Tag: refpurpose
en: Returns a multipolygon geometry formed by the union of pixels that have a pixel value that is not no data value. If no band number is specified, band num defaults to 1.
fr: Retourne une géométrie multipolygonale formée par l'union des pixels dont la valeur est différente de nodata. Si aucune bande bandnum n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: Availability: 0.1.6 Requires GDAL 1.7 or higher.
fr: Disponibilité : 0.1.6 Nécessite GDAL 1.7 ou plus.

note: Tag: para
en: Enhanced: 2.1.0 Improved Speed (fully C-Based) and the returning multipolygon is ensured to be valid.
fr: Amélioration : 2.1.0 Vitesse améliorée (entièrement en C) et le multipolygone retourné est garanti d'être valide.

note: Tag: para
en: Changed: 2.1.0 In prior versions would sometimes return a polygon, changed to always return multipolygon.
fr: Changement : 2.1.0 Dans les versions précédentes, retournait parfois un polygone, retourne désormais toujours un multipolygon.

note: Tag: title
en: Raster Operators
fr: Opérateurs raster

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box intersects B's bounding box.
fr: Retourne <varname>TRUE</varname> si la boite englobante de A intersecte la boite englobante de B.

note: Tag: para
en: The <varname>&amp;&amp;</varname> operator returns <varname>TRUE</varname> if the bounding box of raster/geometr A intersects the bounding box of raster/geometr B.
fr: L'opérateur <varname>&amp;&amp;</varname> retourne <varname>TRUE</varname> si la boîte englobante du raster/géométrie A intersecte la boîte englobante du raster/géométrie B.

note: Tag: para
en: This operand will make use of any indexes that may be available on the rasters.
fr: Cet opérande utilisera tous les index qui peuvent être disponibles sur les données raster.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is to the left of B's.
fr: Retourne <varname>TRUE</varname> si la boîte englobante de A est à gauche de celle de B.

note: Tag: para
en: The <varname>&amp;&lt;</varname> operator returns <varname>TRUE</varname> if the bounding box of raster A overlaps or is to the left of the bounding box of raster B, or more accurately, overlaps or is NOT to the right of the bounding box of raster B.
fr: L'opérateur <varname>&amp;&lt;</varname> retourne <varname>TRUE</varname> si la boîte englobante du raster A chevauche ou est à gauche de la boîte englobante de B ou, plus précisément, si elle chevauche ou n'est PAS à droite de la boîte englobante de B.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is to the right of B's.
fr: Retourne <varname>TRUE</varname> si la boîte englobante de A est à droite de celle de B.

note: Tag: para
en: The <varname>&amp;&gt;</varname> operator returns <varname>TRUE</varname> if the bounding box of raster A overlaps or is to the right of the bounding box of raster B, or more accurately, overlaps or is NOT to the left of the bounding box of raster B.
fr: L'opérateur <varname>&amp;&gt;</varname> retourne <varname>TRUE</varname> si la boîte englobante du raster A chevauche ou est à droite de la boîte englobante du raster B ou, plus précisément, si elle chevauche ou n'est PAS à gauche de la boîte englobante du raster B.

note: Tag: para
en: This operand will make use of any indexes that may be available on the geometries.
fr: Cette opérande utilisera tous les index qui peuvent être disponibles sur les géométries.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is the same as B's. Uses double precision bounding box.
fr: Retourne <varname>TRUE</varname> si la boîte englobante de A est la même que celle de B. Utilise des boîtes englobantes en double précision.

note: Tag: para
en: The <varname>&#61;</varname> operator returns <varname>TRUE</varname> if the bounding box of raster A is the same as the bounding box of raster B. PostgreSQL uses the =, &lt;, and &gt; operators defined for rasters to perform internal orderings and comparison of rasters (ie. in a GROUP BY or ORDER BY clause).
fr: L'opérateur <varname>&#61;</varname> retourne <varname>TRUE</varname> si la boîte englobante du raster A est la même que celle du raster B. PostgreSQL utilise les opérateurs =, &lt;, et &gt; définis pour les rasters pour effectuer des tris et comparaisons internes sur les rasters (par exemple, dans une clause GROUP BY ou ORDER BY).

note: Tag: para
en: This operand will NOT make use of any indexes that may be available on the rasters. Use <xref linkend="RT_Raster_Same"/> instead. This operator exists mostly so one can group by the raster column.
fr: Cet opérande n'utilisera PAS les index éventuellement disponibles sur les données raster. Utilisez plutôt <xref linkend="RT_Raster_Same"/>. Cet opérateur existe principalement pour permettre le regroupement par colonne raster.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is contained by B's. Uses double precision bounding box.
fr: Retourne <varname>TRUE</varname> si la boîte englobante de A est contenue dans celle de B. Utilise des boîtes englobantes en double précision.

note: Tag: para
en: The <varname>@</varname> operator returns <varname>TRUE</varname> if the bounding box of raster/geometry A is contained by bounding box of raster/geometr B.
fr: L'opérateur <varname>@</varname> retourne <varname>TRUE</varname> si la boîte englobante du raster/géométrie A est contenue dans la boîte englobante du raster/géométrie B.

note: Tag: para
en: This operand will use spatial indexes on the rasters.
fr: Cet opérande utilisera des index spatiaux sur les données raster.

note: Tag: para
en: Availability: 2.0.0 raster @ raster, raster @ geometry introduced
fr: Disponibilité : 2.0.0 ajout de raster @ raster, raster @ geometry

note: Tag: para
en: Availability: 2.0.5 geometry @ raster introduced
fr: Disponibilité : 2.0.5 ajout de geometry @ raster

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is the same as B's.
fr: Renvoie <varname>TRUE</varname> si la boîte de délimitation de A est la même que celle de B.

note: Tag: para
en: The <varname>~=</varname> operator returns <varname>TRUE</varname> if the bounding box of raster A is the same as the bounding box of raster B.
fr: L'opérateur <varname>~=</varname> retourne <varname>TRUE</varname> si la boîte englobante du raster A est la même que la boîte englobante du raster B.

note: Tag: para
en: Very useful usecase is for taking two sets of single band rasters that are of the same chunk but represent different themes and creating a multi-band raster
fr: Un cas d'utilisation très utile est celui où l'on prend deux ensembles de rasters à bande unique qui sont du même morceau mais représentent des thèmes différents, et où l'on crée un raster multi-bandes

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is contains B's. Uses double precision bounding box.
fr: Retourne <varname>TRUE</varname> si la boîte englobante de A contient celle de B. Utilise des boîtes englobantes en double précision.

note: Tag: para
en: The <varname>~</varname> operator returns <varname>TRUE</varname> if the bounding box of raster/geometry A is contains bounding box of raster/geometr B.
fr: L'opérateur <varname>~</varname> retourne <varname>TRUE</varname> si la boîte englobante du raster/géométrie A contient la boîte englobante du raster/géométrie B.

note: Tag: title
en: Raster and Raster Band Spatial Relationships
fr: Relations spatiales entre raster et entre bandes raster

note: Tag: refpurpose
en: Return true if no points of raster rastB lie in the exterior of raster rastA and at least one point of the interior of rastB lies in the interior of rastA.
fr: Retourne true si aucun point du raster rastB ne se trouve à l'extérieur du raster rastA et si au moins un point de l'intérieur du raster rastB se trouve à l'intérieur du raster rastA.

note: Tag: para
en: Raster rastA contains rastB if and only if no points of rastB lie in the exterior of rastA and at least one point of the interior of rastB lies in the interior of rastA. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
fr: Le raster rastA contient rastB si et seulement si aucun point de rastB ne se trouve à l'extérieur de rastA et si au moins un point de l'intérieur de rastB se trouve à l'intérieur de rastA. Si le numéro de bande n'est pas spécifié (ou si NULL), seule l'enveloppe convexe du raster est prise en compte dans le test. Si un numéro de bande est spécifié, seuls les pixels ayant une valeur (différente de NODATA) sont pris en compte dans le test.

note: Tag: para
en: This function will make use of any indexes that may be available on the rasters.
fr: Cette fonction utilisera tous les index qui peuvent être disponibles sur les données raster.

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_Contains(ST_Polygon(raster), geometry) or ST_Contains(geometry, ST_Polygon(raster)).
fr: Pour tester la relation spatiale entre un raster et une géométrie, utilisez ST_Polygon sur le raster, par exemple ST_Contains(ST_Polygon(raster), geometry) ou ST_Contains(geometry, ST_Polygon(raster)).

note: Tag: para
en: ST_Contains() is the inverse of ST_Within(). So, ST_Contains(rastA, rastB) implies ST_Within(rastB, rastA).
fr: ST_Contains() est l'inverse de ST_Within(). Ainsi, ST_Contains(rastA, rastB) implique ST_Within(rastB, rastA).

note: Tag: refpurpose
en: Return true if rastB intersects the interior of rastA but not the boundary or exterior of rastA.
fr: Retourne true si rastB intersecte l'intérieur de rastA, mais pas la frontière ou l'extérieur de rastA.

note: Tag: para
en: Raster rastA contains properly rastB if rastB intersects the interior of rastA but not the boundary or exterior of rastA. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
fr: Le raster rastA contient proprement rastB si rastB intersecte l'intérieur de rastA mais pas la limite ou l'extérieur de rastA. Si le numéro de bande n'est pas spécifié (ou si NULL), seule l'enveloppe convexe du raster est prise en compte dans le test. Si le numéro de bande est spécifié, seuls les pixels ayant une valeur (différente de NODATA) sont pris en compte dans le test.

note: Tag: para
en: Raster rastA does not contain properly itself but does contain itself.
fr: Le raster rastA ne contient pas proprement lui-même, mais il se contient lui-même.

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_ContainsProperly(ST_Polygon(raster), geometry) or ST_ContainsProperly(geometry, ST_Polygon(raster)).
fr: Pour tester la relation spatiale entre un raster et une géométrie, utilisez ST_Polygon sur le raster, par exemple ST_ContainsProperly(ST_Polygon(raster), geometry) ou ST_ContainsProperly(geometry, ST_Polygon(raster)).

note: Tag: refpurpose
en: Return true if no points of raster rastB lie outside raster rastA.
fr: Retourne true si aucun point du raster rastB ne se trouve à l'extérieur du raster rastA.

note: Tag: para
en: Raster rastA covers rastB if and only if no points of rastB lie in the exterior of rastA. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
fr: Le raster rastA recouvre le raster rastB si et seulement si aucun point du raster rastB ne se trouve à l'extérieur du raster rastA. Si le numéro de bande n'est pas spécifié (ou si NULL), seule l'enveloppe convexe du raster est prise en compte dans le test. Si le numéro de bande est spécifié, seuls les pixels ayant une valeur (différente de NODATA) sont pris en compte dans le test.

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_Covers(ST_Polygon(raster), geometry) or ST_Covers(geometry, ST_Polygon(raster)).
fr: Pour tester la relation spatiale entre un raster et une géométrie, utilisez ST_Polygon sur le raster, par exemple ST_Covers(ST_Polygon(raster), geometry) ou ST_Covers(geometry, ST_Polygon(raster)).

note: Tag: refpurpose
en: Return true if no points of raster rastA lie outside raster rastB.
fr: Retourne true si aucun point du raster rastA ne se trouve à l'extérieur du raster rastB.

note: Tag: para
en: Raster rastA is covered by rastB if and only if no points of rastA lie in the exterior of rastB. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
fr: Le raster rastA est couvert par rastB si et seulement si aucun point de rastA ne se trouve à l'extérieur de rastB. Si le numéro de bande n'est pas spécifié (ou si NULL), seule l'enveloppe convexe du raster est prise en compte dans le test. Si le numéro de bande est spécifié, seuls les pixels ayant une valeur (différente de NODATA) sont pris en compte dans le test.

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_CoveredBy(ST_Polygon(raster), geometry) or ST_CoveredBy(geometry, ST_Polygon(raster)).
fr: Pour tester la relation spatiale entre un raster et une géométrie, utilisez ST_Polygon sur le raster, par exemple ST_CoveredBy(ST_Polygon(raster), geometry) ou ST_CoveredBy(geometry, ST_Polygon(raster)).

note: Tag: refpurpose
en: Return true if raster rastA does not spatially intersect rastB.
fr: Retourne true si le raster rastA n'intersecte pas spatialement le rastB.

note: Tag: para
en: Raster rastA and rastB are disjointed if they do not share any space together. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
fr: Les rasters rastA et rastB sont disjoints s'ils ne partagent aucun espace. Si le numéro de bande n'est pas spécifié (ou si NULL), seule l'enveloppe convexe du raster est prise en compte dans le test. Si le numéro de bande est spécifié, seuls les pixels ayant une valeur (différente de NODATA) sont pris en compte dans le test.

note: Tag: para
en: This function does NOT use any indexes.
fr: Cette fonction n'utilise PAS d'index.

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_Disjoint(ST_Polygon(raster), geometry).
fr: Pour tester la relation spatiale entre un raster et une géométrie, utilisez ST_Polygon sur le raster, par exemple ST_Disjoint(ST_Polygon(raster), geometry).

note: Tag: refpurpose
en: Return true if raster rastA spatially intersects raster rastB.
fr: Retourne vrai si le raster rastA intersecte spatialement le raster rastB.

note: Tag: para
en: Return true if raster rastA spatially intersects raster rastB. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
fr: Retourne vrai si le raster rastA intersecte spatialement le raster rastB. Si le numéro de bande n'est pas spécifié (ou si NULL), seule l'enveloppe convexe du raster est prise en compte dans le test. Si le numéro de bande est spécifié, seuls les pixels ayant une valeur (différente de NODATA) sont pris en compte dans le test.

note: Tag: para
en: Enhanced: 2.0.0 support raster/raster intersects was introduced.
fr: Amélioration : 2.0.0 ajout de l'intersection raster/raster.

note: Tag: para
en: Changed: 2.1.0 The behavior of the ST_Intersects(raster, geometry) variants changed to match that of ST_Intersects(geometry, raster).
fr: Changement : 2.1.0 Le fonctionnement des variantes ST_Intersects(raster, geometry) a changé pour correspondre au fonctionnement de ST_Intersects(geometry, raster).

note: Tag: refpurpose
en: Return true if raster rastA and rastB intersect but one does not completely contain the other.
fr: Retourne true si les raster rastA et rastB intersectent mais que l'un ne contient pas complètement l'autre.

note: Tag: para
en: Return true if raster rastA spatially overlaps raster rastB. This means that rastA and rastB intersect but one does not completely contain the other. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
fr: Retourne true si le raster rastA recouvre spatialement le raster rastB. Cela signifie que rastA et rastB intersectent mais que l'un ne contient pas complètement l'autre. Si le numéro de bande n'est pas spécifié (ou si NULL), seule l'enveloppe convexe du raster est prise en compte dans le test. Si le numéro de bande est spécifié, seuls les pixels ayant une valeur (différente de NODATA) sont pris en compte dans le test.

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_Overlaps(ST_Polygon(raster), geometry).
fr: Pour tester la relation spatiale entre un raster et une géométrie, utilisez ST_Polygon sur le raster, par exemple ST_Overlaps(ST_Polygon(raster), geometry).

note: Tag: refpurpose
en: Return true if raster rastA and rastB have at least one point in common but their interiors do not intersect.
fr: Retourne true si les raster rastA et rastB ont au moins un point en commun mais que leurs intérieurs n'intersectent pas.

note: Tag: para
en: Return true if raster rastA spatially touches raster rastB. This means that rastA and rastB have at least one point in common but their interiors do not intersect. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
fr: Retourne true si le raster rastA touche spatialement le raster rastB. Cela signifie que rastA et rastB ont au moins un point en commun mais que leurs intérieurs n’intersectent pas. Si le numéro de bande n'est pas spécifié (ou si NULL), seule l'enveloppe convexe du raster est prise en compte dans le test. Si le numéro de bande est spécifié, seuls les pixels ayant une valeur (différente de NODATA) sont pris en compte dans le test.

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_Touches(ST_Polygon(raster), geometry).
fr: Pour tester la relation spatiale entre un raster et une géométrie, utilisez ST_Polygon sur le raster, par exemple ST_Touches(ST_Polygon(raster), geometry).

note: Tag: refpurpose
en: Returns true if rasters have same skew, scale, spatial ref, and offset (pixels can be put on same grid without cutting into pixels) and false if they don't with notice detailing issue.
fr: Retourne true si les rasters ont les mêmes skew, scale, spatial ref, et offset (les pixels peuvent être placés sur la même grille sans être coupés) et false si ce n'est pas le cas, avec une NOTICE détaillant le problème.

note: Tag: para
en: Non-Aggregate version (Variants 1 and 2): Returns true if the two rasters (either provided directly or made using the values for upperleft, scale, skew and srid) have the same scale, skew, srid and at least one of any of the four corners of any pixel of one raster falls on any corner of the grid of the other raster. Returns false if they don't and a NOTICE detailing the alignment issue.
fr: Version non agrégée (variantes 1 et 2) : Retourne true si les deux rasters (fournis directement ou créés en utilisant les valeurs pour upperleft, scale, skew et srid) ont la même échelle, le même skew, le même srid et si au moins un des quatre coins de n'importe quel pixel d'un raster tombe sur n'importe quel coin de la grille de l'autre raster. Retourne false si ce n'est pas le cas et un NOTICE détaillant le problème d'alignement.

note: Tag: para
en: Aggregate version (Variant 3): From a set of rasters, returns true if all rasters in the set are aligned. The ST_SameAlignment() function is an "aggregate" function in the terminology of PostgreSQL. That means that it operates on rows of data, in the same way the SUM() and AVG() functions do.
fr: Version agrégée (variante 3) : A partir d'un ensemble de rasters, retourne vrai si tous les rasters de l'ensemble sont alignés. La fonction ST_SameAlignment() est une fonction "agrégée" dans la terminologie de PostgreSQL. Cela signifie qu'elle opère sur des lignes de données, de la même manière que les fonctions SUM() et AVG().

note: Tag: para
en: Enhanced: 2.1.0 addition of Aggegrate variant
fr: Amélioration : 2.1.0 ajout de la variante agrégée

note: Tag: title
en: Examples: Rasters
fr: Exemples : Rasters

note: Tag: refpurpose
en: <refpurpose>Returns text stating if rasters are aligned and if not aligned, a reason why.</refpurpose>
fr: <refpurpose>Retourne un texte indiquant si les rasters sont alignés et, s'ils ne le sont pas, la raison du problème.</refpurpose>

note: Tag: para
en: <para>Returns text stating if rasters are aligned and if not aligned, a reason why.</para>
fr: <para>Retourne un texte indiquant si les rasters sont alignés et, s'ils ne le sont pas, la raison du problème.</para>

note: Tag: para
en: If there are several reasons why the rasters are not aligned, only one reason (the first test to fail) will be returned.
fr: S'il y a plusieurs raisons pour lesquelles les rasters ne sont pas alignés, une seule raison (le premier test qui a échoué) sera retournée.

note: Tag: refpurpose
en: Return true if no points of raster rastA lie in the exterior of raster rastB and at least one point of the interior of rastA lies in the interior of rastB.
fr: Retourne true si aucun point du raster rastA ne se trouve à l'extérieur du raster rastB et si au moins un point de l'intérieur du raster rastA se trouve à l'intérieur du raster rastB.

note: Tag: para
en: Raster rastA is within rastB if and only if no points of rastA lie in the exterior of rastB and at least one point of the interior of rastA lies in the interior of rastB. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
fr: Le raster rastA est compris dans rastB si et seulement si aucun point de rastA ne se trouve à l'extérieur de rastB et si au moins un point de l'intérieur de rastA se trouve à l'intérieur de rastB. Si le numéro de bande n'est pas spécifié (ou si NULL), seule l'enveloppe convexe du raster est prise en compte dans le test. Si le numéro de bande est spécifié, seuls les pixels ayant une valeur (différente de NODATA) sont pris en compte dans le test.

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_Within(ST_Polygon(raster), geometry) or ST_Within(geometry, ST_Polygon(raster)).
fr: Pour tester la relation spatiale entre un raster et une géométrie, utilisez ST_Polygon sur le raster, par exemple ST_Within(ST_Polygon(raster), geometry) ou ST_Within(geometry, ST_Polygon(raster)).

note: Tag: para
en: ST_Within() is the inverse of ST_Contains(). So, ST_Within(rastA, rastB) implies ST_Contains(rastB, rastA).
fr: ST_Within() est l'inverse de ST_Contains(). Ainsi, ST_Within(rastA, rastB) implique ST_Contains(rastB, rastA).

note: Tag: refpurpose
en: Return true if rasters rastA and rastB are within the specified distance of each other.
fr: Retourne true si les rasters rastA et rastB se trouvent à une distance donnée l'un de l'autre.

note: Tag: para
en: Return true if rasters rastA and rastB are within the specified distance of each other. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
fr: Retourne true si les rasters rastA et rastB sont à la distance spécifiée l'un de l'autre. Si le numéro de bande n'est pas spécifié (ou si NULL), seule l'enveloppe convexe du raster est prise en compte dans le test. Si le numéro de bande est spécifié, seuls les pixels ayant une valeur (différente de NODATA) sont pris en compte dans le test.

note: Tag: para
en: The distance is specified in units defined by the spatial reference system of the rasters. For this function to make sense, the source rasters must both be of the same coordinate projection, having the same SRID.
fr: La distance est spécifiée en unités définies par le système de référence spatiale des rasters. Pour que cette fonction ait un sens, les rasters sources doivent avoir la même projection de coordonnées et le même SRID.

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_DWithin(ST_Polygon(raster), geometry).
fr: Pour tester la relation spatiale entre un raster et une géométrie, utilisez ST_Polygon sur le raster, par exemple ST_DWithin(ST_Polygon(raster), geometry).

note: Tag: refpurpose
en: Return true if rasters rastA and rastB are fully within the specified distance of each other.
fr: Retourne true si les rasters rastA et rastB se trouvent entièrement à une distance donnée l'un de l'autre.

note: Tag: para
en: Return true if rasters rastA and rastB are fully within the specified distance of each other. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
fr: Retourne true si les rasters rastA et rastB sont entièrement à une distance donnée l'un de l'autre. Si le numéro de bande n'est pas spécifié (ou si NULL), seule l'enveloppe convexe du raster est prise en compte dans le test. Si le numéro de bande est spécifié, seuls les pixels ayant une valeur (différente de NODATA) sont pris en compte dans le test.

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_DFullyWithin(ST_Polygon(raster), geometry).
fr: Pour tester la relation spatiale entre un raster et une géométrie, utilisez ST_Polygon sur le raster, par exemple ST_DFullyWithin(ST_Polygon(raster), geometry).

note: Tag: para
en: This section documents various gotchas and tips related to PostGIS Raster.
fr: Cette section présente divers pièges et astuces liés à PostGIS raster.

note: Tag: title
en: Raster Tips
fr: Astuces raster

note: Tag: title
en: Out-DB Rasters
fr: Rasters out-DB

note: Tag: title
en: Directory containing many files
fr: Répertoire contenant de nombreux fichiers

note: Tag: para
en: When GDAL opens a file, GDAL eagerly scans the directory of that file to build a catalog of other files. If this directory contains many files (e.g. thousands, millions), opening that file becomes extremely slow (especially if that file happens to be on a network drive such as NFS).
fr: Lorsque GDAL ouvre un fichier, il parcourt l'entièreté du répertoire du fichier pour construire un catalogue d'autres fichiers. Si ce répertoire contient de nombreux fichiers (par exemple des milliers, des millions), l'ouverture de ce fichier devient extrêmement lente (en particulier si ce fichier se trouve sur un lecteur réseau tel que NFS).

note: Tag: para
en: To control this behavior, GDAL provides the following environment variable: <ulink url="https://trac.osgeo.org/gdal/wiki/ConfigOptions#GDAL_DISABLE_READDIR_ON_OPEN">GDAL_DISABLE_READDIR_ON_OPEN</ulink>. Set <varname>GDAL_DISABLE_READDIR_ON_OPEN</varname> to <varname>TRUE</varname> to disable directory scanning.
fr: Pour contrôler ce comportement, GDAL fournit la variable d'environnement suivante : <ulink url="https://trac.osgeo.org/gdal/wiki/ConfigOptions#GDAL_DISABLE_READDIR_ON_OPEN">GDAL_DISABLE_READDIR_ON_OPEN</ulink>. Définissez <varname>GDAL_DISABLE_READDIR_ON_OPEN</varname> à <varname>TRUE</varname> pour désactiver l'analyse des répertoires.

note: Tag: para
en: In Ubuntu (and assuming you are using PostgreSQL's packages for Ubuntu), <varname>GDAL_DISABLE_READDIR_ON_OPEN</varname> can be set in <emphasis>/etc/postgresql/POSTGRESQL_VERSION/CLUSTER_NAME/environment</emphasis> (where POSTGRESQL_VERSION is the version of PostgreSQL, e.g. 9.6 and CLUSTER_NAME is the name of the cluster, e.g. maindb). You can also set PostGIS environment variables here as well.
fr: Sous Ubuntu (et en supposant que vous utilisez les paquets PostgreSQL pour Ubuntu), <varname>GDAL_DISABLE_READDIR_ON_OPEN</varname> peut être défini dans <emphasis>/etc/postgresql/POSTGRESQL_VERSION/CLUSTER_NAME/environment</emphasis> (où POSTGRESQL_VERSION est la version de PostgreSQL, par ex.9.6 et CLUSTER_NAME est le nom du cluster, par exemple maindb). Vous pouvez également définir les variables d'environnement PostGIS ici.

note: Tag: title
en: Maximum Number of Open Files
fr: Nombre maximum de fichiers ouverts

note: Tag: para
en: The maximum number of open files permitted by Linux and PostgreSQL are typically conservative (typically 1024 open files per process) given the assumption that the system is consumed by human users. For Out-DB Rasters, a single valid query can easily exceed this limit (e.g. a dataset of 10 year's worth of rasters with one raster for each day containing minimum and maximum temperatures and we want to know the absolute min and max value for a pixel in that dataset).
fr: Le nombre maximum de fichiers ouverts autorisé par Linux et PostgreSQL est généralement prudent (typiquement 1024 fichiers ouverts par processus), étant donné l'hypothèse que le système est utilisé par des utilisateurs humains. Pour les rasters Out-DB, une seule requête valide peut facilement dépasser cette limite (par exemple, un jeu de données de 10 ans avec un raster pour chaque jour contenant les températures minimales et maximales et nous voulons connaître les valeurs min et max absolues pour un pixel dans ce jeu de données).

note: Tag: para
en: The easiest change to make is the following PostgreSQL setting: <ulink url="https://www.postgresql.org/docs/current/static/runtime-config-resource.html#GUC-MAX-FILES-PER-PROCESS">max_files_per_process</ulink>. The default is set to 1000, which is far too low for Out-DB Rasters. A safe starting value could be 65536 but this really depends on your datasets and the queries run against those datasets. This setting can only be made on server start and probably only in the PostgreSQL configuration file (e.g. <emphasis>/etc/postgresql/POSTGRESQL_VERSION/CLUSTER_NAME/postgresql.conf</emphasis> in Ubuntu environments).
fr: Le changement le plus simple à effectuer est le paramètre suivant de PostgreSQL : <ulink url="https://www.postgresql.org/docs/current/static/runtime-config-resource.html#GUC-MAX-FILES-PER-PROCESS">max_files_per_process</ulink>. La valeur par défaut est de 1000, ce qui est beaucoup trop faible pour les données raster Out-DB. Une valeur de départ sûre pourrait être 65536, mais cela dépend vraiment de vos ensembles de données et des requêtes exécutées sur ces ensembles de données. Ce paramètre ne peut être défini qu'au démarrage du serveur et probablement uniquement dans le fichier de configuration de PostgreSQL (par exemple <emphasis>/etc/postgresql/POSTGRESQL_VERSION/CLUSTER_NAME/postgresql.conf</emphasis> dans les environnements Ubuntu).

note: Tag: para
en: The major change to make is the Linux kernel's open files limits. There are two parts to this:
fr: La principale modification à apporter concerne les limites des fichiers ouverts du noyau Linux. Il y a deux parties à cela :

note: Tag: para
en: <para>Maximum number of open files for the entire system</para>
fr: <para>Nombre maximal de fichiers ouverts pour l'ensemble du système</para>

note: Tag: para
en: <para>Maximum number of open files per process</para>
fr: <para>Nombre maximal de fichiers ouverts par processus</para>

note: Tag: title
en: <title>Maximum number of open files for the entire system</title>
fr: <title>Nombre maximal de fichiers ouverts pour l'ensemble du système</title>

note: Tag: para
en: You can inspect the current maximum number of open files for the entire system with the following example:
fr: L'exemple suivant vous permet de connaître le nombre maximum de fichiers ouverts sur l'ensemble du système :

note: Tag: para
en: If the value returned is not large enough, add a file to <emphasis>/etc/sysctl.d/</emphasis> as per the following example:
fr: Si la valeur retournée n'est pas assez importante, ajoutez un fichier dans <emphasis>/etc/sysctl.d/</emphasis> comme dans l'exemple suivant :

note: Tag: title
en: <title>Maximum number of open files per process</title>
fr: <title>Nombre maximal de fichiers ouverts par processus</title>

note: Tag: para
en: We need to increase the maximum number of open files per process for the PostgreSQL server processes.
fr: Nous devons augmenter le nombre maximum de fichiers ouverts par processus pour les processus du serveur PostgreSQL.

note: Tag: para
en: To see what the current PostgreSQL service processes are using for maximum number of open files, do as per the following example (make sure to have PostgreSQL running):
fr: Pour connaître le nombre maximal de fichiers ouverts utilisé par les processus de service PostgreSQL, suivez l'exemple suivant (assurez-vous que PostgreSQL est en cours d'exécution) :

note: Tag: para
en: In the example above, we inspected the open files limit for Process 31718. It doesn't matter which PostgreSQL process, any of them will do. The response we are interested in is <emphasis>Max open files</emphasis>.
fr: Dans l'exemple ci-dessus, nous avons inspecté la limite des fichiers ouverts pour le processus 31718. Peu importe le processus PostgreSQL, n'importe lequel fera l'affaire. La réponse qui nous intéresse est <emphasis>Max open files</emphasis>.

note: Tag: para
en: We want to increase <emphasis>Soft Limit</emphasis> and <emphasis>Hard Limit</emphasis> of <emphasis>Max open files</emphasis> to be greater than the value we specified for the PostgreSQL setting <varname>max_files_per_process</varname>. In our example, we set <varname>max_files_per_process</varname> to 65536.
fr: Nous voulons augmenter <emphasis>Soft Limit</emphasis> et <emphasis>Hard Limit</emphasis> de <emphasis>Max open files</emphasis> pour qu'il soit supérieur à la valeur que nous avons spécifiée pour le paramètre PostgreSQL <varname>max_files_per_process</varname>. Dans notre exemple, nous avons fixé <varname>max_files_per_process</varname> à 65536.

note: Tag: para
en: In Ubuntu (and assuming you are using PostgreSQL's packages for Ubuntu), the easiest way to change the <emphasis>Soft Limit</emphasis> and <emphasis>Hard Limit</emphasis> is to edit <emphasis role="strong">/etc/init.d/postgresql</emphasis> (SysV) or <emphasis role="strong">/lib/systemd/system/postgresql*.service</emphasis> (systemd).
fr: Sous Ubuntu (et en supposant que vous utilisez les paquets PostgreSQL pour Ubuntu), la façon la plus simple de changer les paramètres <emphasis>Soft Limit</emphasis> et <emphasis>Hard Limit</emphasis> est d'éditer <emphasis role="strong">/etc/init.d/postgresql</emphasis> (SysV) ou <emphasis role="strong">/lib/systemd/system/postgresql*.service</emphasis> (systemd).

note: Tag: para
en: Let's first address the SysV Ubuntu case where we add <emphasis role="strong">ulimit -H -n 262144</emphasis> and <emphasis role="strong">ulimit -n 131072</emphasis> to <emphasis role="strong">/etc/init.d/postgresql</emphasis>.
fr: Commençons par le cas de SysV Ubuntu où nous ajoutons <emphasis role="strong">ulimit -H -n 262144</emphasis> et <emphasis role="strong">ulimit -n 131072</emphasis> à <emphasis role="strong">/etc/init.d/postgresql</emphasis>.

note: Tag: para
en: Now to address the systemd Ubuntu case. We will add <emphasis role="strong">LimitNOFILE=131072</emphasis> to every <emphasis role="strong">/lib/systemd/system/postgresql*.service</emphasis> file in the <emphasis role="strong">[Service]</emphasis> section.
fr: Passons maintenant au cas de systemd Ubuntu. Nous ajouterons <emphasis role="strong">LimitNOFILE=131072</emphasis> à chaque fichier <emphasis role="strong">/lib/systemd/system/postgresql*.service</emphasis> dans la section <emphasis role="strong">[Service]</emphasis>.

note: Tag: para
en: After making the necessary systemd changes, make sure to reload the daemon
fr: Après avoir effectué les changements nécessaires à systemd, assurez-vous de recharger le démon
