介绍¶

在 RasterIO 之前，有一个用于访问GIS字段中使用的许多不同类型的栅格数据文件的python选择，即 GDAL （ Geospatial Data Abstraction Library）。这个绑定扩展了 Python，但很少为 GDAL 的 C API提供抽象。这意味着使用它们的 Python 程序趋向于像C程序一样读取和运行。例如，GDAL 的 Python 绑定要求用户注意空的C指针，因为可能导致程序崩溃。这是不好的：在其他考虑因素中，我们选择了 Python 而不是 C 来避免指针问题。

在Python标准库中进行地理空间数据抽象是什么感觉？使用现代Python语言特性和习语的人？一种让用户不必担心悬空指针和其他C编程缺陷的方法？

Rasterio的目标是成为这种栅格数据库——使用更少的非惯用扩展类和更多的惯用python类型和协议表达gdal的数据模型，同时执行与gdal的python绑定一样快。

高性能、低认知负载、更清晰、更透明的代码。这就 RasterIO 的目的。

RasterIO 许可证¶

只要满足以下条件，允许以源形式和二进制形式重新分配和使用，不论是否修改：

源代码的再分配必须保留上述版权声明、此条件列表和以下免责声明。
以二进制形式进行的再分配必须复制上述版权声明、本条件列表以及随再分配提供的文档和/或其他材料中的以下免责声明。
未经特别事先书面许可，不得使用Mapbox的名称或其贡献者的名称来认可或推广本软件衍生的产品。

依赖关系¶

RasterIO 有一个C库依赖项： GDAL >=1.11 。 GDAL 本身依赖于大多数主要操作系统提供的许多其他库，也依赖于非标准 Geos 和 Proj4 库。

Python 包依赖项（另请参见requirements.txt）： affine , cligj , click , enum34 , numpy 。

开发还需要（参见requirements-dev.txt）Cython和其他包。

从二进制文件安装¶

OS X¶

包含gdal、geos和proj4库的二进制车轮可用于OS X 10.7+版本，从Rasterio 0.17版开始。要安装，请运行 pip install rasterio . 这些二进制车轮是较新版本的PIP的首选。如果不需要这些轮子，并且希望从源分发版安装，请运行 pip install rasterio –no-use-wheel 相反。

包含的gdal库是相当小的，只提供gdal附带的默认启用的格式驱动程序。要获得对更多格式的访问权，必须从源分发版构建（请参见下文）。

其他操作系统的二进制轮子将在未来的版本中提供。

Windows¶

Rasterio和Gdal的二进制车轮由Christoph Gohlke创建，可从他的网站上获得。

要安装Rasterio，请下载系统的两个二进制文件 (rasterio 和 GDAL ）从下载文件夹中运行类似的程序：

$ pip install -U pip $ pip install GDAL-1.11.2-cp27-none-win32.whl $ pip install rasterio-0.24.0-cp27-none-win32.whl

与 Python 一起安装¶

要在 Python 发行版上安装栅格，请访问 rasterio conda-forge 安装说明页。此构建与Pypi上的栅格分布分开维护，包装问题应在 rasterio conda-forge 问题跟踪器。

从源分发安装¶

Rasterio是一个python c扩展，要构建它，您需要一个工作的编译器（Xcodeon OSX等）。您还需要预安装numpy；运行rasterio安装脚本需要numpy头文件。必须先安装numpy（通过指定的需求文件），然后才能安装栅格。看拉斯泰里奥的特拉维斯 configuration 更多指导。

Linux系统¶

以下命令改编自Rasterio的Travis CI配置。

$ sudo add-apt-repository ppa:ubuntugis/ppa $ sudo apt-get update $ sudo apt-get install python-numpy gdal-bin libgdal-dev $ pip install rasterio

根据需要为Linux系统调整它们。

操作系统X¶

对于基于自制的Python环境，请执行以下操作。

$ brew install gdal $ pip install rasterio

Windows 您可以从下载gdal的二进制发行版 here . 您还需要下载已编译的库和头文件（包括文件）。

在Windows上从源代码构建时，必须知道setup.py不能依赖仅在UNIX系统上存在的gdal config来发现Rasterio需要编译其C扩展名的头文件和库的位置。在Windows上，这些路径需要由用户提供。您需要找到gdal的include文件和库文件，并使用如下的setup.py。

$ python setup.py build_ext -I<path to gdal include files> -lgdal_i -L<path to gdal library> $ python setup.py install

我们已经成功地使用Microsoft的Visual Studio的同一版本编译了代码，该版本用于编译Python的目标版本（有关使用的版本的详细信息 here 。）

注意：gdal dll（gdal111.dll）和gdal数据目录需要位于Windows路径中，否则Rasterio将无法工作。

目录

常见问题

介绍¶