目录

关注公众号


常见问题

  1. Windows下的安装说明
  2. Jupyter免费在线实验环境
  3. 勘误与补充


介绍

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 许可证

版权所有(c)2016,Mapbox保留所有权利。

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

  • 源代码的再分配必须保留上述版权声明、此条件列表和以下免责声明。

  • 以二进制形式进行的再分配必须复制上述版权声明、本条件列表以及随再分配提供的文档和/或其他材料中的以下免责声明。

  • 未经特别事先书面许可,不得使用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将无法工作。