52 uint32_t hasnodata,
double nodataval,
62 double src_nodataval = 0.0;
76 assert(NULL != srcband);
77 assert(NULL != exprset && exprcount > 0);
89 numval = width * height;
93 rterror(
"rt_band_reclass: Could not allocate memory for band");
99 memset(mem, 0, memsize);
103 int32_t checkvalint = 0;
105 double checkvaldouble = 0;
106 float checkvalfloat = 0;
113 for (i = 0; i < numval; i++)
114 ptr[i] = clamped_initval;
115 checkvalint = ptr[0];
122 for (i = 0; i < numval; i++)
123 ptr[i] = clamped_initval;
124 checkvalint = ptr[0];
131 for (i = 0; i < numval; i++)
132 ptr[i] = clamped_initval;
133 checkvalint = ptr[0];
140 for (i = 0; i < numval; i++)
141 ptr[i] = clamped_initval;
142 checkvalint = ptr[0];
149 for (i = 0; i < numval; i++)
150 ptr[i] = clamped_initval;
151 checkvalint = ptr[0];
158 for (i = 0; i < numval; i++)
159 ptr[i] = clamped_initval;
160 checkvalint = ptr[0];
167 for (i = 0; i < numval; i++)
168 ptr[i] = clamped_initval;
169 checkvalint = ptr[0];
176 for (i = 0; i < numval; i++)
177 ptr[i] = clamped_initval;
178 checkvalint = ptr[0];
185 for (i = 0; i < numval; i++)
186 ptr[i] = clamped_initval;
187 checkvaluint = ptr[0];
194 for (i = 0; i < numval; i++)
195 ptr[i] = clamped_initval;
196 checkvalfloat = ptr[0];
202 for (i = 0; i < numval; i++)
204 checkvaldouble = ptr[0];
209 rterror(
"rt_band_reclass: Unknown pixeltype %d", pixtype);
218 checkvalint, checkvaluint,
219 checkvalfloat, checkvaldouble,
223 RASTER_DEBUGF(3,
"rt_band_reclass: width = %d height = %d", width, height);
227 rterror(
"rt_band_reclass: Could not create new band");
234 for (
x = 0;
x < width;
x++) {
235 for (
y = 0;
y < height;
y++) {
243 RASTER_DEBUGF(4,
"(x, y, ov, isnodata) = (%d, %d, %f, %d)",
x,
y, ov, isnodata);
249 if (hasnodata && isnodata) {
254 for (i = 0; i < exprcount; i++) {
285 ov < expr->src.max ||
299 if (!do_nv)
continue;
309 if (hasnodata && isnodata) {
322 nv = (((ov - expr->
src.
min) * nr) / or) + expr->
dst.
min;
328 else if (nv < expr->dst.max)
333 if (nv < expr->dst.min)
335 else if (nv > expr->
dst.
max)
357 RASTER_DEBUGF(4,
"(%d, %d) ov: %f or: %f - %f nr: %f - %f nv: %f"
361 , (NULL != expr) ? expr->
src.
min : 0
362 , (NULL != expr) ? expr->
src.
max : 0
363 , (NULL != expr) ? expr->
dst.
min : 0
364 , (NULL != expr) ? expr->
dst.
max : 0
368 rterror(
"rt_band_reclass: Could not assign value to new band");
426 if (_param == NULL) {
427 rterror(
"_rti_iterator_arg_init: Could not allocate memory for _rti_iterator_arg");
436 _param->
width = NULL;
463 if (_param->
raster != NULL)
467 if (_param->
width != NULL)
469 if (_param->
height != NULL)
483 if (_param->
offset != NULL) {
484 for (i = 0; i < _param->
count; i++) {
485 if (_param->
offset[i] == NULL)
509 if (_param->
arg != NULL) {
515 for (i = 0; i < _param->
count; i++) {
534 uint16_t distancex, uint16_t distancey,
535 int *allnull,
int *allempty
540 _param->
count = itrcount;
563 _param->
width == NULL ||
572 rterror(
"_rti_iterator_arg_populate: Could not allocate memory for children of _rti_iterator_arg");
584 for (i = 0; i < itrcount; i++) {
588 _param->
width[i] = 0;
600 if (itrset[i].
raster == NULL) {
619 if (!itrset[i].nbnodata) {
620 rterror(
"_rti_iterator_arg_populate: Band %d not found for raster %d", itrset[i].
nband, i);
624 RASTER_DEBUGF(4,
"Band %d not found for raster %d. Using NODATA", itrset[i].
nband, i);
632 rterror(
"_rti_iterator_arg_populate: Could not get band %d for raster %d", itrset[i].
nband, i);
660 if (_param->
offset[i] == NULL) {
661 rterror(
"_rti_iterator_arg_populate: Could not allocate memory for offsets");
677 rterror(
"_rti_iterator_arg_empty_init: Could not allocate memory for empty values and NODATA");
686 rterror(
"_rti_iterator_arg_empty_init: Could not allocate memory for elements of empty values and NODATA");
704 if (_param->
arg == NULL) {
705 rterror(
"_rti_iterator_arg_callback_init: Could not allocate memory for rt_iterator_arg");
718 rterror(
"_rti_iterator_arg_callback_init: Could not allocate memory for element of rt_iterator_arg");
721 memset(_param->
arg->
values, 0,
sizeof(
double **) * _param->
count);
725 for (i = 0; i < _param->
count; i++) {
729 rterror(
"_rti_iterator_arg_callback_init: Could not allocate memory for position elements of rt_iterator_arg");
750 for (i = 0; i < _param->
count; i++) {
816 uint8_t hasnodata,
double nodataval,
817 uint16_t distancex, uint16_t distancey,
840 double offset[4] = {0.};
861 assert(itrset != NULL && itrcount > 0);
862 assert(rtnraster != NULL);
868 if (callback == NULL) {
869 rterror(
"rt_raster_iterator: Callback function not provided");
875 rterror(
"rt_raster_iterator: Custom extent cannot be empty if extent type is ET_CUSTOM");
881 rterror(
"rt_raster_iterator: Pixel type cannot be PT_END");
887 rterror(
"rt_raster_iterator: Could not initialize internal variables");
893 rterror(
"rt_raster_iterator: Could not populate for internal variables");
899 if (allnull == itrcount) {
900 RASTER_DEBUG(3,
"all rasters are NULL, returning NULL");
907 else if (allempty == itrcount) {
908 RASTER_DEBUG(3,
"all rasters are empty, returning empty raster");
913 if (rtnrast == NULL) {
914 rterror(
"rt_raster_iterator: Could not create empty raster");
919 *rtnraster = rtnrast;
930 RASTER_DEBUG(4,
"using custom extent as reference raster");
935 for (i = 0; i < itrcount; i++) {
937 RASTER_DEBUGF(4,
"using raster at index %d as reference raster", i);
946 rterror(
"rt_raster_iterator: Could not find reference raster to use for alignment tests");
959 rterror(
"rt_raster_iterator: Could not test for alignment between reference raster and custom extent");
971 for (i = 0; i < itrcount; i++) {
977 rterror(
"rt_raster_iterator: Could not test for alignment between reference raster and raster %d", i);
983 RASTER_DEBUGF(5,
"raster at index %d alignment: %d", i, aligned);
994 rterror(
"rt_raster_iterator: The set of rasters provided (custom extent included, if appropriate) do not have the same alignment");
1003 switch (extenttype) {
1008 if (rtnrast == NULL) {
1009 rterror(
"rt_raster_iterator: Could not allocate memory for output raster");
1016 for (i = 0; i < itrcount; i++) {
1023 rtnrast->
bands = NULL;
1027 for (i = i + 1; i < itrcount; i++) {
1035 rterror(
"rt_raster_iterator: Could not compute %s extent of rasters",
1036 extenttype ==
ET_UNION ?
"union" :
"intersection"
1044 rtinfo(
"rt_raster_iterator: Computed raster for %s extent is empty",
1045 extenttype ==
ET_UNION ?
"union" :
"intersection"
1075 if (i < 0) i = itrcount - 1;
1078 if (_param->
raster[i] == NULL) {
1079 RASTER_DEBUGF(3,
"returning NULL as %s raster is NULL and extent type is ET_%s",
1080 (i == 0 ?
"first" : (i == 1 ?
"second" :
"last")),
1081 (i == 0 ?
"FIRST" : (i == 1 ?
"SECOND" :
"LAST"))
1089 else if (_param->
isempty[i]) {
1090 RASTER_DEBUGF(3,
"returning empty raster as %s raster is empty and extent type is ET_%s",
1091 (i == 0 ?
"first" : (i == 1 ?
"second" :
"last")),
1092 (i == 0 ?
"FIRST" : (i == 1 ?
"SECOND" :
"LAST"))
1098 if (rtnrast == NULL) {
1099 rterror(
"rt_raster_iterator: Could not create empty raster");
1104 *rtnraster = rtnrast;
1111 if (rtnrast == NULL) {
1112 rterror(
"rt_raster_iterator: Could not allocate memory for output raster");
1119 switch (extenttype) {
1121 memcpy(rtnrast, customextent,
sizeof(
struct rt_raster_t));
1129 rtnrast->
bands = NULL;
1136 RASTER_DEBUGF(4,
"rtnrast (width, height, ulx, uly, scalex, scaley, skewx, skewy, srid) = (%d, %d, %f, %f, %f, %f, %f, %f, %d)",
1150 rterror(
"rt_raster_iterator: Could not initialize empty values and NODATA");
1163 hasnodata, nodataval,
1166 rterror(
"rt_raster_iterator: Could not add new band to output raster");
1176 if (rtnband == NULL) {
1177 rterror(
"rt_raster_iterator: Could not get new band from output raster");
1190 rterror(
"rt_raster_iterator: Could not initialize callback function argument");
1200 for (i = 0; i < itrcount; i++) {
1207 rterror(
"rt_raster_iterator: Could not compute raster offsets");
1216 _param->
offset[i][0] = offset[2];
1217 _param->
offset[i][1] = offset[3];
1218 RASTER_DEBUGF(4,
"rast %d offset: %f %f", i, offset[2], offset[3]);
1224 for (_y = 0; _y < _height; _y++) {
1225 for (_x = 0; _x < _width; _x++) {
1226 RASTER_DEBUGF(4,
"iterating output pixel (x, y) = (%d, %d)", _x, _y);
1231 for (i = 0; i < itrcount; i++) {
1244 RASTER_DEBUG(4,
"empty raster, band does not exist or band is NODATA. using empty values and NODATA");
1256 x = _x - (int) _param->
offset[i][0];
1257 y = _y - (
int) _param->
offset[i][1];
1266 if (distancex > 0 && distancey > 0) {
1272 distancex, distancey,
1277 rterror(
"rt_raster_iterator: Could not get pixel neighborhood");
1290 (
x >= 0 && x < _param->width[i]) &&
1291 (
y >= 0 && y < _param->height[i])
1300 rterror(
"rt_raster_iterator: Could not get the pixel value of band");
1312 RASTER_DEBUG(4,
"Outside band extent, setting value to NODATA");
1331 if (npixels == NULL) {
1332 rterror(
"rt_raster_iterator: Could not reallocate memory for neighborhood");
1341 npixels[status - 1].
x =
x;
1342 npixels[status - 1].
y =
y;
1343 npixels[status - 1].
nodata = 1;
1347 if ((!_param->
band.
hasnodata[i] && inextent) || !isnodata) {
1348 npixels[status - 1].
nodata = 0;
1354 npixels, status, mask,
1356 distancex, distancey,
1363 rterror(
"rt_raster_iterator: Could not create 2D array of neighborhood");
1377 status = callback(_param->
arg, userarg, &
value, &nodata);
1384 rterror(
"rt_raster_iterator: Callback function returned an error");
1399 else if (!hasnodata) {
1401 RASTER_DEBUGF(4,
"burning pixel (%d, %d) with minval: %f", _x, _y, minval);
1407 rterror(
"rt_raster_iterator: Could not set pixel value");
1421 *rtnraster = rtnrast;
1452 rterror(
"_rti_colormap_arg_init: Could not allocate memory for _rti_color_arg");
1466 if (arg->
raster == NULL) {
1467 rterror(
"_rti_colormap_arg_init: Could not create output raster");
1485 if (arg->
raster != NULL) {
1498 for (i = 0; i < arg->
nexpr; i++) {
1499 if (arg->
expr[i] != NULL)
1534 assert(colormap != NULL);
1541 if (colormap->
nentry < 1) {
1542 rterror(
"rt_raster_colormap: colormap must have at least one entry");
1548 rterror(
"rt_raster_colormap: raster has no band at index %d",
nband);
1554 rterror(
"rt_raster_colormap: Could not get band at index %d",
nband);
1561 rterror(
"rt_raster_colormap: Could not initialize internal variables");
1572 if (colormap->
ncolor < 1) {
1573 rterror(
"rt_raster_colormap: At least one color must be provided");
1577 else if (colormap->
ncolor > 4) {
1578 rtinfo(
"More than four colors indicated. Using only the first four colors");
1585 if (arg->
pos == NULL) {
1586 rterror(
"rt_raster_colormap: Could not allocate memory for valid entries");
1590 for (i = 0, j = 0; i < colormap->
nentry; i++) {
1597 rtwarn(
"More than one colormap entry found for NODATA value. Only using first NOTDATA entry");
1607 if (colormap->
method == CM_INTERPOLATE && arg->
npos < 2) {
1608 rtwarn(
"Method INTERPOLATE requires at least two non-NODATA colormap entries. Using NEAREST instead");
1609 colormap->
method = CM_NEAREST;
1614 rtinfo(
"Band at index %d has no NODATA value. Ignoring NODATA entry",
nband);
1622 if (colormap->
method == CM_INTERPOLATE)
1625 else if (colormap->
method == CM_EXACT)
1632 if (arg->
expr == NULL) {
1633 rterror(
"rt_raster_colormap: Could not allocate memory for reclass expressions");
1640 for (i = 0; i < arg->
nexpr; i++) {
1642 if (arg->
expr[i] == NULL) {
1643 rterror(
"rt_raster_colormap: Could not allocate memory for reclass expression");
1651 for (i = 0; i < colormap->
ncolor; i++) {
1671 RASTER_DEBUGF(4,
"NODATA expr[%d]->src (min, max, in, ix, en, ex) = (%f, %f, %d, %d, %d, %d)",
1680 RASTER_DEBUGF(4,
"NODATA expr[%d]->dst (min, max, in, ix, en, ex) = (%f, %f, %d, %d, %d, %d)",
1694 for (j = 0; j < arg->
npos; j++) {
1695 if (colormap->
method == CM_INTERPOLATE) {
1696 if (j == arg->
npos - 1)
1716 else if (colormap->
method == CM_NEAREST) {
1719 if (j != arg->
npos - 1) {
1752 else if (colormap->
method == CM_EXACT) {
1770 RASTER_DEBUGF(4,
"expr[%d]->src (min, max, in, ix, en, ex) = (%f, %f, %d, %d, %d, %d)",
1780 RASTER_DEBUGF(4,
"expr[%d]->dst (min, max, in, ix, en, ex) = (%f, %f, %d, %d, %d, %d)",
1794 if (colormap->
method == CM_EXACT) {
1811 RASTER_DEBUGF(4,
"expr[%d]->src (min, max, in, ix, en, ex) = (%f, %f, %d, %d, %d, %d)",
1821 RASTER_DEBUGF(4,
"expr[%d]->dst (min, max, in, ix, en, ex) = (%f, %f, %d, %d, %d, %d)",
1836 if (arg->
band == NULL) {
1837 rterror(
"rt_raster_colormap: Could not reclassify band");
1844 rterror(
"rt_raster_colormap: Could not add reclassified band to output raster");
rt_band rt_band_new_inline(uint16_t width, uint16_t height, rt_pixtype pixtype, uint32_t hasnodata, double nodataval, uint8_t *data)
Create an in-db rt_band with no data.
void rt_band_set_ownsdata_flag(rt_band band, int flag)
void rterror(const char *fmt,...)
Wrappers used for reporting errors and info.
void * rtalloc(size_t size)
Wrappers used for managing memory.
uint16_t rt_band_get_width(rt_band band)
Return width of this band.
#define RASTER_DEBUG(level, msg)
int32_t rt_raster_get_srid(rt_raster raster)
Get raster's SRID.
#define RASTER_DEBUGF(level, msg,...)
double rt_raster_get_x_skew(rt_raster raster)
Get skew about the X axis.
double rt_raster_get_x_offset(rt_raster raster)
Get raster x offset, in projection units.
int rt_raster_generate_new_band(rt_raster raster, rt_pixtype pixtype, double initialvalue, uint32_t hasnodata, double nodatavalue, int index)
Generate a new inline band and add it to a raster.
int8_t rt_util_clamp_to_8BSI(double value)
uint8_t rt_util_clamp_to_1BB(double value)
void rtinfo(const char *fmt,...)
int32_t rt_util_clamp_to_32BSI(double value)
void rt_raster_set_scale(rt_raster raster, double scaleX, double scaleY)
Set scale in projection units.
int rt_raster_add_band(rt_raster raster, rt_band band, int index)
Add band data to a raster.
int rt_band_get_hasnodata_flag(rt_band band)
Get hasnodata flag value.
rt_errorstate rt_band_get_pixel(rt_band band, int x, int y, double *value, int *nodata)
Get pixel value.
void rt_raster_destroy(rt_raster raster)
Release memory associated to a raster.
int rt_band_get_isnodata_flag(rt_band band)
Get isnodata flag value.
rt_raster rt_raster_new(uint32_t width, uint32_t height)
Construct a raster with given dimensions.
int rt_util_dbl_trunc_warning(double initialvalue, int32_t checkvalint, uint32_t checkvaluint, float checkvalfloat, double checkvaldouble, rt_pixtype pixtype)
int rt_raster_has_band(rt_raster raster, int nband)
Return TRUE if the raster has a band of this number.
struct rt_pixel_t * rt_pixel
double rt_raster_get_x_scale(rt_raster raster)
Get scale X in projection units.
uint8_t rt_util_clamp_to_2BUI(double value)
void rtwarn(const char *fmt,...)
uint8_t rt_util_clamp_to_8BUI(double value)
double rt_band_get_min_value(rt_band band)
Returns the minimal possible value for the band according to the pixel type.
rt_errorstate rt_band_set_pixel(rt_band band, int x, int y, double val, int *converted)
Set single pixel's value.
rt_errorstate
Enum definitions.
void rt_band_destroy(rt_band band)
Destroy a raster band.
int16_t rt_util_clamp_to_16BSI(double value)
void * rtrealloc(void *mem, size_t size)
uint16_t rt_raster_get_num_bands(rt_raster raster)
rt_raster rt_raster_clone(rt_raster raster, uint8_t deep)
Clone an existing raster.
uint16_t rt_raster_get_height(rt_raster raster)
rt_errorstate rt_band_get_nodata(rt_band band, double *nodata)
Get NODATA value.
uint8_t rt_util_clamp_to_4BUI(double value)
rt_errorstate rt_pixel_set_to_array(rt_pixel npixel, uint32_t count, rt_mask mask, int x, int y, uint16_t distancex, uint16_t distancey, double ***value, int ***nodata, int *dimx, int *dimy)
uint16_t rt_raster_get_width(rt_raster raster)
uint32_t rt_band_get_nearest_pixel(rt_band band, int x, int y, uint16_t distancex, uint16_t distancey, int exclude_nodata_value, rt_pixel *npixels)
Get nearest pixel(s) with value (not NODATA) to specified pixel.
void rtdealloc(void *mem)
uint16_t rt_util_clamp_to_16BUI(double value)
uint32_t rt_util_clamp_to_32BUI(double value)
rt_errorstate rt_raster_from_two_rasters(rt_raster rast1, rt_raster rast2, rt_extenttype extenttype, rt_raster *rtnraster, double *offset)
double rt_raster_get_y_scale(rt_raster raster)
Get scale Y in projection units.
float rt_util_clamp_to_32F(double value)
rt_errorstate rt_raster_same_alignment(rt_raster rast1, rt_raster rast2, int *aligned, char **reason)
double rt_raster_get_y_skew(rt_raster raster)
Get skew about the Y axis.
uint16_t rt_band_get_height(rt_band band)
Return height of this band.
int rt_pixtype_size(rt_pixtype pixtype)
Return size in bytes of a value in the given pixtype.
double rt_raster_get_y_offset(rt_raster raster)
Get raster y offset, in projection units.
int rt_raster_is_empty(rt_raster raster)
Return TRUE if the raster is empty.
rt_band rt_raster_get_band(rt_raster raster, int bandNum)
Return Nth band, or NULL if unavailable.
This library is the generic raster handling section of PostGIS.
raster
Be careful!! Zeros function's input parameter can be a (height x width) array, not (width x height): ...
rt_band rt_band_reclass(rt_band srcband, rt_pixtype pixtype, uint32_t hasnodata, double nodataval, rt_reclassexpr *exprset, int exprcount)
Returns new band with values reclassified.
static void _rti_colormap_arg_destroy(_rti_colormap_arg arg)
static int _rti_iterator_arg_callback_init(_rti_iterator_arg _param)
rt_raster rt_raster_colormap(rt_raster raster, int nband, rt_colormap colormap)
Returns a new raster with up to four 8BUI bands (RGBA) from applying a colormap to the user-specified...
static int _rti_iterator_arg_empty_init(_rti_iterator_arg _param)
struct _rti_colormap_arg_t * _rti_colormap_arg
static _rti_iterator_arg _rti_iterator_arg_init()
struct _rti_iterator_arg_t * _rti_iterator_arg
static int _rti_iterator_arg_populate(_rti_iterator_arg _param, rt_iterator itrset, uint16_t itrcount, uint16_t distancex, uint16_t distancey, int *allnull, int *allempty)
rt_errorstate rt_raster_iterator(rt_iterator itrset, uint16_t itrcount, rt_extenttype extenttype, rt_raster customextent, rt_pixtype pixtype, uint8_t hasnodata, double nodataval, uint16_t distancex, uint16_t distancey, rt_mask mask, void *userarg, int(*callback)(rt_iterator_arg arg, void *userarg, double *value, int *nodata), rt_raster *rtnraster)
n-raster iterator.
static void _rti_iterator_arg_callback_clean(_rti_iterator_arg _param)
static void _rti_iterator_arg_destroy(_rti_iterator_arg _param)
static _rti_colormap_arg _rti_colormap_arg_init(rt_raster raster)
rt_colormap_entry nodataentry
struct _rti_iterator_arg_t::@10 band
struct _rti_iterator_arg_t::@11 distance
struct _rti_iterator_arg_t::@13 empty
struct _rti_iterator_arg_t::@12 dimension
enum rt_colormap_t::@9 method
struct rt_reclassexpr_t::rt_reclassrange src
struct rt_reclassexpr_t::rt_reclassrange dst