DatasetGrid类参考

栅格数据集类。 更多...

继承自Dataset。

所有成员的列表。

公有成员
(NSInteger)	- width
	获取栅格数据集的栅格的宽度。单位为像素。
(NSInteger)	- height
	获取栅格数据集的栅格的高度。单位为像素。
(void)	- setGeoReference:
	将栅格数据集对应到地理坐标系中指定的地理范围。
(OCPixelFormat)	- pixelFormat
	获取栅格数据存储的像素格式。每个像素采用不同的字节进行表示，单位为比特（bit）。
(NSInteger)	- blockSize
	获取栅格数据集分块存储的大小。
(NSInteger)	- rowBlockCount
	获取栅格数据经过分块后所得到的总行数。
(NSInteger)	- columnBlockCount
	获取栅格数据经过分块后所得到的总列数。
(double)	- value:row:
	根据给定的行数和列数返回栅格数据集的栅格所对应的栅格值
(Point2D *)	- gridToXY:
	根据指定的行数和列数所对应的栅格点转换为地理坐标系下的点，即 X, Y 坐标。
(CGPoint)	- xyToGrid:
	将地理坐标系下的点（X Y）转换为栅格数据集中对应的栅格。
(BOOL)	- updatePyramid:
	按指定范围更新栅格数据集影像金字塔。
(BOOL)	- buildPyramid
(BOOL)	- removePyramid
(BOOL)	- update:
	根据指定的栅格数据集更新。
(StatisticsResult *)	- buildStatistics
	返回栅格数据集像素的统计结果，包括最大值、最小值、均值、中值、众数、稀数、方差、标准差。
(StatisticsResult *)	- gridStatisticsResult
	返回栅格数据集像素的统计结果，包括最大值、最小值、均值、中值、众数、稀数、方差、标准差。
保护属性
GeoRegion *	_clipRegion
属性
double	noValue
	获取或设置栅格数据集的空值，当此数据集为空值时，用户可采用-9999来表示。
double	minValue
	获取栅格数据集中栅格值的最小值。
double	maxValue
	获取栅格数据集中栅格值的最大值。
BOOL	hasPyramid
	获取栅格数据集是否已创建金字塔。true，表示已创建金字塔，false，表示未创建金字塔。
BOOL	calculateExtremum
	计算栅格数据集的极值，即最大值和最小值。建议：栅格数据集在一些分析或者操作之后，建议调用此接口，计算一下最大最小值。
GeoRegion *	clipRegion
	获取或设置栅格数据集的显示区域，若用户设置了栅格数据集的显示区域，栅格数据集就按照给定的区域进行显示，区域之外的都不显示。
Colors *	colorTable
	获取或设置颜色表，关闭数据集时不保存对颜色表进行的设置。

---

详细描述

栅格数据集类。

栅格数据集类，该类用于描述栅格数据，例如高程数据集和土地利用图。栅格数据采用网格形式组织并使用二维的栅格的像素值来记录数据，每个栅格（cell）代表一个像素要素，栅格值可以描述各种数据信息。

栅格数据集中每 一个栅格（cell）存储的是表示地物的属性值，属性值可以是土壤类型、密度值、高程、温度、湿度等。

注意： 在对数据集进行操作前需要先打开数据集，即调用 [Dataset open]方法。

---

成员函数文档

- (NSInteger) blockSize

获取栅格数据集分块存储的大小。

返回:

栅格数据集分块存储的大小。

- (BOOL) buildPyramid

- (StatisticsResult *) buildStatistics

返回栅格数据集像素的统计结果，包括最大值、最小值、均值、中值、众数、稀数、方差、标准差。

返回:

返回统计结果对象。

- (NSInteger) columnBlockCount

获取栅格数据经过分块后所得到的总列数。

返回:

栅格数据经过分块后所得到的总列数。

- (StatisticsResult *) gridStatisticsResult

返回栅格数据集像素的统计结果，包括最大值、最小值、均值、中值、众数、稀数、方差、标准差。

返回:

返回统计结果对象。

- (Point2D *) gridToXY:

(CGPoint)

point

根据指定的行数和列数所对应的栅格点转换为地理坐标系下的点，即 X, Y 坐标。

参数:

point

指定的行数和列数多对应的栅格。

返回:

地理坐标系下的对应的点坐标。

- (NSInteger) height

获取栅格数据集的栅格的高度。单位为像素。

返回:

栅格数据集的栅格的高度。

- (OCPixelFormat) pixelFormat

获取栅格数据存储的像素格式。每个像素采用不同的字节进行表示，单位为比特（bit）。

返回:

栅格数据存储的像素格式。

- (BOOL) removePyramid

- (NSInteger) rowBlockCount

获取栅格数据经过分块后所得到的总行数。

返回:

栅格数据经过分块后所得到的总行数。

- (void) setGeoReference:

(Rectangle2D *)

value

将栅格数据集对应到地理坐标系中指定的地理范围。

参数:

value

指定的地理范围。

- (BOOL) update:

(DatasetGrid *)

dataset

根据指定的栅格数据集更新。

指定的栅格数据集和被更新的栅格数据集的编码方式（EncodeType）和像素类型（PixelFormat）必须保持一致。

参数:

dataset

指定的栅格数据集。

返回:

一个布尔值，表示更新是否成功，如果更新成功，返回 true，否则返回 false。

- (BOOL) updatePyramid:

(Rectangle2D *)

value

按指定范围更新栅格数据集影像金字塔。

参数:

value

更新金字塔的指定影像范围。

返回:

如果更新成功，返回 true，否则返回 false。

- (double) value:		(NSInteger)	column
row:		(NSInteger)	row

根据给定的行数和列数返回栅格数据集的栅格所对应的栅格值

参数:

	column	指定的栅格数据集中的列数。
	row	指定的栅格数据集中的行数。

返回:

栅格数据经过分块后所得到的总列数。

- (NSInteger) width

获取栅格数据集的栅格的宽度。单位为像素。

返回:

栅格数据集的栅格的宽度。

- (CGPoint) xyToGrid:

(Point2D *)

point2D

将地理坐标系下的点（X Y）转换为栅格数据集中对应的栅格。

参数:

point2D

指定的地理坐标系下的点。

返回:

栅格数据集对应的栅格。

---

成员数据文档

- (GeoRegion*) _clipRegion [protected]

---

属性文档

- (BOOL) calculateExtremum [read, assign]

计算栅格数据集的极值，即最大值和最小值。建议：栅格数据集在一些分析或者操作之后，建议调用此接口，计算一下最大最小值。

返回:

如果计算成功返回 true，否则返回 false。

- (GeoRegion*) clipRegion [read, write, assign]

获取或设置栅格数据集的显示区域，若用户设置了栅格数据集的显示区域，栅格数据集就按照给定的区域进行显示，区域之外的都不显示。

注意： 1. 当用户所设定的栅格数据集的地理范围与所设定的裁剪区域无重叠区域，栅格数据集不显示。 2. 当重新设置栅格数据集的地理范围，不自动修改栅格数据集的裁剪区域。

返回:

如果计算成功返回 true，否则返回 false。

- (Colors*) colorTable [read, write, assign]

获取或设置颜色表，关闭数据集时不保存对颜色表进行的设置。

返回:

颜色表。

- (BOOL) hasPyramid [read, assign]

获取栅格数据集是否已创建金字塔。true，表示已创建金字塔，false，表示未创建金字塔。

返回:

栅格数据集是否已创建金字塔。

- (double) maxValue [read, assign]

获取栅格数据集中栅格值的最大值。

返回:

栅格数据集中栅格值的最大值。

- (double) minValue [read, assign]

获取栅格数据集中栅格值的最小值。

返回:

栅格数据集中栅格值的最小值。

- (double) noValue [read, write, assign]

获取或设置栅格数据集的空值，当此数据集为空值时，用户可采用-9999来表示。

返回:

栅格数据集的空值。

---

该类的文档由以下文件生成：

• DatasetGrid.h