Beschreibung

Gibt einen Raster aus, der nach der Eingabegeometrie geom ausgeschnitten wird. Wird kein Band angegeben, so werden alle Bänder bearbeitet.

Raster die aus einer Operation mit ST_Clip resultieren, müssen in den Bereichen wo sie ausgeschnitten werden, einen NODATA-Wert für jedes Band aufweisen. Wenn keine Werte übergeben werden und für den Ausgangsraster kein NODATA-Wert festgelegt wurde, dann werden die NODATA-Werte des Zielrasters auf ST_MinPossibleValue(ST_BandPixelType(rast, band)) gesetzt. Wenn die Anzahl der NODATA-Werte in dem übergebenen Feld kleiner als die Anzahl der Bänder ist, wird für die restlichen Bänder der letzte Wert des Feldes verwendet. Wenn die Anzahl der NODATA-Werte größer als die Anzahl der Bänder ist, so werden die zusätzlichen NODATA-Werte übergangen. Alle Varianten, die ein Feld mit NODATA-Werten akzeptieren, nehmen auch einen einzelnen Wert für alle Bänder entgegen.

Wenn crop nicht angegeben ist, wird TRUE angenommen. Dies bedeutet, dass der Ergebnisraster auf die Ausdehnung der Verschneidung von geom und rast zugeschnitten wird. Wenn crop auf FALSE gesetzt ist, hat der neue Raster dieselbe Ausdehnung wie rast.

Verfügbarkeit: 2.0.0

Erweiterung: 2.1.0 neu geschrieben in C

Diese Beispiele nutzen Luftbilddaten aus Massachusetts, die von MassGIS Aerial Orthos heruntergeladen werden können. Die Koordinaten liegen in "Massachusetts State Plane Meters" vor.

Beispiele: 1 Band ausschneiden

-- Clip the first band of an aerial tile by a 20 meter buffer.
SELECT ST_Clip(rast, 1,
        ST_Buffer(ST_Centroid(ST_Envelope(rast)),20)
    ) from aerials.boston
WHERE rid = 4;
                    

-- Demonstrate effect of crop on final dimensions of raster
-- Note how final extent is clipped to that of the geometry
-- if crop = true
SELECT ST_XMax(ST_Envelope(ST_Clip(rast, 1, clipper, true))) As xmax_w_trim,
    ST_XMax(clipper) As xmax_clipper,
    ST_XMax(ST_Envelope(ST_Clip(rast, 1, clipper, false))) As xmax_wo_trim,
    ST_XMax(ST_Envelope(rast)) As xmax_rast_orig
FROM (SELECT rast, ST_Buffer(ST_Centroid(ST_Envelope(rast)),6) As clipper
    FROM aerials.boston
WHERE rid = 6) As foo;

   xmax_w_trim    |   xmax_clipper   |   xmax_wo_trim   |  xmax_rast_orig
------------------+------------------+------------------+------------------
 230657.436173996 | 230657.436173996 | 230666.436173996 | 230666.436173996
                    

Die gesamte Rasterkachel vor dem Ausschneiden

Nach dem Ausschneiden

Beispiele: 1 Band ohne "crop" ausschneiden und die anderen Bänder ungeändert erneut hinzufügen

-- Same example as before, but we need to set crop to false to be able to use ST_AddBand
-- because ST_AddBand requires all bands be the same Width and height
SELECT ST_AddBand(ST_Clip(rast, 1,
        ST_Buffer(ST_Centroid(ST_Envelope(rast)),20),false
    ), ARRAY[ST_Band(rast,2),ST_Band(rast,3)] ) from aerials.boston
WHERE rid = 6;
                    

Die gesamte Rasterkachel vor dem Ausschneiden

Nach dem Abschneiden - unwirklich

Beispiele: Alle Bänder ausschneiden

-- Clip all bands of an aerial tile by a 20 meter buffer.
-- Only difference is we don't specify a specific band to clip
-- so all bands are clipped
SELECT ST_Clip(rast,
      ST_Buffer(ST_Centroid(ST_Envelope(rast)), 20),
      false
    ) from aerials.boston
WHERE rid = 4;
                    

Die gesamte Rasterkachel vor dem Ausschneiden

Nach dem Ausschneiden

Siehe auch

ST_AddBand, ST_MapAlgebra (callback function version), ST_Intersection