ST_MakeEmptyRaster
Zurück  11.3. Raster Constructors  Weiter

Name

ST_MakeEmptyRaster — Gibt einen leeren Raster (ohne Bänder), mit den gegebenen Dimensionen (width & height), upperleft X und Y, Pixelgröße, Rotation (scalex, scaley, skewx & skewy) und Koordinatenreferenzsystem (SRID), zurück. Wenn ein Raster übergeben wird, dann wird ein neuer Raster mit der selben Größe, Ausrichtung und SRID zurückgegeben. Wenn SRID nicht angegeben ist, wird das Koordinatenreferenzsystem auf "unknown" (0) gesetzt.

Übersicht

raster ST_MakeEmptyRaster(raster rast);

raster ST_MakeEmptyRaster(integer width, integer height, float8 upperleftx, float8 upperlefty, float8 scalex, float8 scaley, float8 skewx, float8 skewy, integer srid=unknown);

raster ST_MakeEmptyRaster(integer width, integer height, float8 upperleftx, float8 upperlefty, float8 pixelsize);

Description

Gibt einen leeren Raster (ohne Bänder), mit den gegebenen Dimensionen (width & height), georeferenziert in geodätischen (oder geographischen) Koordinaten, oberes linkes X (upperleftx), oberes linkes Y (upperlefty), Pixelgröße, Rotation (scalex, scaley, skewx & skewy) und Koordinatenreferenzsystem (SRID), zurück.

Die letzte Version verwendet einen einzelnen Parameter um die Pixelgröße festzulegen. "scalex" wird auf diesen Übergabewert und "scaley" auf den negativen Wert davon gesetzt. "skewx" und "skewy" werden auf 0 gesetzt.

Wird ein bestehender Raster übergeben, so wird ein neuer Raster mit den gleichen Metadateneinstellungen erstellt (ohne die Bänder).

Wenn die SRID nicht angegeben ist, wird sie standardmäßig auf 0 gesetzt. Nachdem Sie einen leeren Raster erzeugt haben, werden Sie vermutlich Bänder hinzufügen und eventuell auch bearbeiten wollen. Siehe ST_AddBand um die Bänder festzulegen und ST_SetValue um Ausgangswerte für die Pixel zu setzen.

Beispiele

Use an existing raster as a template and output metadata of the rasters we added.

Code
INSERT INTO dummy_rast(rid, rast)
VALUES(3, ST_MakeEmptyRaster(100, 100, 0.0005, 0.0005, 1, 1, 0, 0, 4326) );
INSERT INTO dummy_rast(rid, rast)
SELECT 4, ST_MakeEmptyRaster(rast)
FROM dummy_rast WHERE rid = 3;
SELECT
    rid,
    (md).width,
    (md).height,
    (md).scalex,
    (md).scaley,
    (md).srid
FROM (
    SELECT rid, ST_MetaData(rast) AS md
    FROM dummy_rast
    WHERE rid IN (3, 4)
) AS foo
ORDER BY rid;
Ausgabe von Rastern
rid | width | height | scalex | scaley | srid
-----+-------+--------+--------+--------+------
   3 |   100 |    100 |      1 |      1 | 4326
   4 |   100 |    100 |      1 |      1 | 4326