├── README.md
├── img
    ├── vector.png
    ├── RasterIO.png
    ├── keyvalue.png
    ├── metaData.png
    ├── vc6Link.png
    ├── cameraman.png
    ├── join-clause.png
    ├── multBands.png
    ├── multDataset.png
    ├── select-stmt.png
    ├── vc6Include.png
    ├── vc6setting.png
    ├── vs2010Link1.png
    ├── vs2010Link2.png
    ├── vs2010Include.png
    ├── vs2010setting.png
    ├── classOGRGeometry.png
    ├── opengis_geometry.png
    └── simple-select-stmt.png
├── .gitattributes
├── .hgignore
├── theme
    └── sphinx_rtd_theme
    │   ├── static
    │       ├── fonts
    │       │   ├── Lato-Bold.ttf
    │       │   ├── FontAwesome.otf
    │       │   ├── Lato-Regular.ttf
    │       │   ├── Inconsolata-Bold.ttf
    │       │   ├── RobotoSlab-Bold.ttf
    │       │   ├── Inconsolata-Regular.ttf
    │       │   ├── RobotoSlab-Regular.ttf
    │       │   ├── fontawesome-webfont.eot
    │       │   ├── fontawesome-webfont.ttf
    │       │   ├── fontawesome-webfont.woff
    │       │   └── fontawesome-webfont.woff2
    │       ├── font
    │       │   ├── fontawesome_webfont.eot
    │       │   ├── fontawesome_webfont.ttf
    │       │   └── fontawesome_webfont.woff
    │       ├── css
    │       │   └── badge_only.css
    │       └── js
    │       │   ├── theme.js
    │       │   └── modernizr.min.js
    │   ├── searchbox.html
    │   ├── theme.conf
    │   ├── __init__.py
    │   ├── versions.html
    │   ├── search.html
    │   ├── footer.html
    │   ├── breadcrumbs.html
    │   └── layout.html
├── index.rst
├── ogr_layer_algebra.rst
├── .readthedocs.yaml
├── formats.rst
├── preface.rst
├── gdal-alg.rst
├── code
    ├── gdalwarpsimple.c
    ├── fullcode.c
    └── sub2tif.c
├── ogr-architecture.rst
├── ogr-sql.rst
├── Makefile
├── make.bat
├── gdal-data-model.rst
├── gdal-tool-code.rst
├── sqlite-sql.rst
├── ogr-proj.rst
├── ogr-utilities.rst
├── conf.py
├── ogr-read-write.rst
├── gdal_3_build.rst
└── gdal-cheat-sheet.rst


/README.md:
--------------------------------------------------------------------------------
1 | 
2 | 


--------------------------------------------------------------------------------
/img/vector.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/img/vector.png


--------------------------------------------------------------------------------
/.gitattributes:
--------------------------------------------------------------------------------
1 | # Auto detect text files and perform LF normalization
2 | * text=auto
3 | 


--------------------------------------------------------------------------------
/img/RasterIO.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/img/RasterIO.png


--------------------------------------------------------------------------------
/img/keyvalue.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/img/keyvalue.png


--------------------------------------------------------------------------------
/img/metaData.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/img/metaData.png


--------------------------------------------------------------------------------
/img/vc6Link.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/img/vc6Link.png


--------------------------------------------------------------------------------
/.hgignore:
--------------------------------------------------------------------------------
1 | glob:_build*
2 | glob:*.orig
3 | syntax: glob
4 | theme/sphinx_rtd_theme_new/
5 | 


--------------------------------------------------------------------------------
/img/cameraman.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/img/cameraman.png


--------------------------------------------------------------------------------
/img/join-clause.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/img/join-clause.png


--------------------------------------------------------------------------------
/img/multBands.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/img/multBands.png


--------------------------------------------------------------------------------
/img/multDataset.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/img/multDataset.png


--------------------------------------------------------------------------------
/img/select-stmt.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/img/select-stmt.png


--------------------------------------------------------------------------------
/img/vc6Include.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/img/vc6Include.png


--------------------------------------------------------------------------------
/img/vc6setting.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/img/vc6setting.png


--------------------------------------------------------------------------------
/img/vs2010Link1.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/img/vs2010Link1.png


--------------------------------------------------------------------------------
/img/vs2010Link2.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/img/vs2010Link2.png


--------------------------------------------------------------------------------
/img/vs2010Include.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/img/vs2010Include.png


--------------------------------------------------------------------------------
/img/vs2010setting.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/img/vs2010setting.png


--------------------------------------------------------------------------------
/img/classOGRGeometry.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/img/classOGRGeometry.png


--------------------------------------------------------------------------------
/img/opengis_geometry.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/img/opengis_geometry.png


--------------------------------------------------------------------------------
/img/simple-select-stmt.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/img/simple-select-stmt.png


--------------------------------------------------------------------------------
/theme/sphinx_rtd_theme/static/fonts/Lato-Bold.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/theme/sphinx_rtd_theme/static/fonts/Lato-Bold.ttf


--------------------------------------------------------------------------------
/theme/sphinx_rtd_theme/static/fonts/FontAwesome.otf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/theme/sphinx_rtd_theme/static/fonts/FontAwesome.otf


--------------------------------------------------------------------------------
/theme/sphinx_rtd_theme/static/fonts/Lato-Regular.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/theme/sphinx_rtd_theme/static/fonts/Lato-Regular.ttf


--------------------------------------------------------------------------------
/theme/sphinx_rtd_theme/static/fonts/Inconsolata-Bold.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/theme/sphinx_rtd_theme/static/fonts/Inconsolata-Bold.ttf


--------------------------------------------------------------------------------
/theme/sphinx_rtd_theme/static/fonts/RobotoSlab-Bold.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/theme/sphinx_rtd_theme/static/fonts/RobotoSlab-Bold.ttf


--------------------------------------------------------------------------------
/theme/sphinx_rtd_theme/static/font/fontawesome_webfont.eot:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/theme/sphinx_rtd_theme/static/font/fontawesome_webfont.eot


--------------------------------------------------------------------------------
/theme/sphinx_rtd_theme/static/font/fontawesome_webfont.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/theme/sphinx_rtd_theme/static/font/fontawesome_webfont.ttf


--------------------------------------------------------------------------------
/theme/sphinx_rtd_theme/static/font/fontawesome_webfont.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/theme/sphinx_rtd_theme/static/font/fontawesome_webfont.woff


--------------------------------------------------------------------------------
/theme/sphinx_rtd_theme/static/fonts/Inconsolata-Regular.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/theme/sphinx_rtd_theme/static/fonts/Inconsolata-Regular.ttf


--------------------------------------------------------------------------------
/theme/sphinx_rtd_theme/static/fonts/RobotoSlab-Regular.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/theme/sphinx_rtd_theme/static/fonts/RobotoSlab-Regular.ttf


--------------------------------------------------------------------------------
/theme/sphinx_rtd_theme/static/fonts/fontawesome-webfont.eot:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/theme/sphinx_rtd_theme/static/fonts/fontawesome-webfont.eot


--------------------------------------------------------------------------------
/theme/sphinx_rtd_theme/static/fonts/fontawesome-webfont.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/theme/sphinx_rtd_theme/static/fonts/fontawesome-webfont.ttf


--------------------------------------------------------------------------------
/theme/sphinx_rtd_theme/static/fonts/fontawesome-webfont.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/theme/sphinx_rtd_theme/static/fonts/fontawesome-webfont.woff


--------------------------------------------------------------------------------
/theme/sphinx_rtd_theme/static/fonts/fontawesome-webfont.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wuqi/HeadFirst-GDAL/HEAD/theme/sphinx_rtd_theme/static/fonts/fontawesome-webfont.woff2


--------------------------------------------------------------------------------
/theme/sphinx_rtd_theme/searchbox.html:
--------------------------------------------------------------------------------
 1 | {%- if builder != 'singlehtml' %}
 2 | <div role="search">
 3 |   <form id="rtd-search-form" class="wy-form" action="{{ pathto('search') }}" method="get">
 4 |     <input type="text" name="q" placeholder="{{ _('Search docs') }}" />
 5 |     <input type="hidden" name="check_keywords" value="yes" />
 6 |     <input type="hidden" name="area" value="default" />
 7 |   </form>
 8 | </div>
 9 | {%- endif %}
10 | 


--------------------------------------------------------------------------------
/theme/sphinx_rtd_theme/theme.conf:
--------------------------------------------------------------------------------
 1 | [theme]
 2 | inherit = basic
 3 | stylesheet = css/theme.css
 4 | pygments_style = default
 5 | 
 6 | [options]
 7 | canonical_url = hiw1hhg
 8 | analytics_id =
 9 | collapse_navigation = True
10 | sticky_navigation = True
11 | navigation_depth = 4
12 | includehidden = True
13 | titles_only = 
14 | logo_only =
15 | display_version = True
16 | prev_next_buttons_location = bottom
17 | style_external_links = False
18 | 


--------------------------------------------------------------------------------
/theme/sphinx_rtd_theme/__init__.py:
--------------------------------------------------------------------------------
 1 | """Sphinx ReadTheDocs theme.
 2 | 
 3 | From https://github.com/ryan-roemer/sphinx-bootstrap-theme.
 4 | 
 5 | """
 6 | from os import path
 7 | 
 8 | __version__ = '0.4.1'
 9 | __version_full__ = __version__
10 | 
11 | 
12 | def get_html_theme_path():
13 |     """Return list of HTML theme paths."""
14 |     cur_dir = path.abspath(path.dirname(path.dirname(__file__)))
15 |     return cur_dir
16 | 
17 | # See http://www.sphinx-doc.org/en/stable/theming.html#distribute-your-theme-as-a-python-package
18 | def setup(app):
19 |     app.add_html_theme('sphinx_rtd_theme', path.abspath(path.dirname(__file__)))
20 | 


--------------------------------------------------------------------------------
/index.rst:
--------------------------------------------------------------------------------
 1 | .. headfirst gdal documentation master file, created by
 2 |    sphinx-quickstart on Sat Oct 12 10:16:09 2013.
 3 |    You can adapt this file completely to your liking, but it should at least
 4 |    contain the root `toctree` directive.
 5 |    
 6 | ################
 7 | HeadFirst GDAL
 8 | ################
 9 | 
10 | .. toctree::
11 |     :maxdepth: 3
12 | 
13 |     preface
14 |     formats
15 |     gdal-data-model
16 |     read-and-write
17 |     gdal-utilities
18 |     gdal-tool-code
19 |     gdal-alg
20 |     gdal-cheat-sheet
21 |     gdal-warp-api-tutorial
22 |     static-build
23 |     gdal_3_build
24 |     ogr-architecture
25 |     ogr-proj
26 |     ogr-read-write
27 |     ogr-sql
28 |     sqlite-sql
29 |     ogr-utilities
30 |     ogr_layer_algebra
31 | 
32 | Indices and tables
33 | ==================
34 | 
35 | * :ref:`genindex`
36 | 


--------------------------------------------------------------------------------
/ogr_layer_algebra.rst:
--------------------------------------------------------------------------------
 1 | .. hightlight:: rst
 2 | .. _OGRLayerAlgebra
 3 | 
 4 | 
 5 | ############################
 6 | OGR Layer Algebra
 7 | ############################
 8 | 本章来源 `OGR Layer Algebra <https://gdal.org/development/rfc/rfc39_ogr_layer_algebra.html>`_
 9 | 
10 | ********************
11 | 简介
12 | ********************
13 | `OGRLayer` OGR层类空间分析的基本功能,包括 `Intersection Union  SymDifference Identity Update Clip Erase`几种基础功能
14 | 
15 | 代码如下:
16 | 
17 | .. code-block:: c++
18 | 
19 |     char **param = NULL;
20 |     param = CSLAddString(param, "INPUT_PREFIX=o_");
21 |     param = CSLAddString(param, "METHOD_PREFIX=n_");
22 |     param = CSLAddString(param, "SKIP_FAILURES=YES");
23 |     OGRErr err = oldLayer->Union(newLayer, outLayer, 
24 |                                  param, NULL, NULL);
25 |     if (err != OGRERR_NONE)
26 |     {
27 |         gError(LOG_CAT, "Union error");
28 |         CSLDestroy(param);
29 |         break;
30 |     }
31 |     CSLDestroy(param);
32 |     outLayer->SyncToDisk();
33 | 
34 | 


--------------------------------------------------------------------------------
/.readthedocs.yaml:
--------------------------------------------------------------------------------
 1 | # Read the Docs configuration file for Sphinx projects
 2 | # See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
 3 | 
 4 | # Required
 5 | version: 2
 6 | 
 7 | # Set the OS, Python version and other tools you might need
 8 | build:
 9 |   os: ubuntu-22.04
10 |   tools:
11 |     python: "3.11"
12 |     # You can also specify other tool versions:
13 |     # nodejs: "20"
14 |     # rust: "1.70"
15 |     # golang: "1.20"
16 | 
17 | # Build documentation in the "docs/" directory with Sphinx
18 | sphinx:
19 |   configuration: ./conf.py
20 |   # You can configure Sphinx to use a different builder, for instance use the dirhtml builder for simpler URLs
21 |   # builder: "dirhtml"
22 |   # Fail on all warnings to avoid broken references
23 |   # fail_on_warning: true
24 | 
25 | # Optionally build your docs in additional formats such as PDF and ePub
26 | # formats:
27 | #    - pdf
28 | #    - epub
29 | 
30 | # Optional but recommended, declare the Python requirements required
31 | # to build your documentation
32 | # See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
33 | # python:
34 | #    install:
35 | #    - requirements: docs/requirements.txt


--------------------------------------------------------------------------------
/theme/sphinx_rtd_theme/versions.html:
--------------------------------------------------------------------------------
 1 | {% if READTHEDOCS %}
 2 | {# Add rst-badge after rst-versions for small badge style. #}
 3 |   <div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
 4 |     <span class="rst-current-version" data-toggle="rst-current-version">
 5 |       <span class="fa fa-book"> Read the Docs</span>
 6 |       v: {{ current_version }}
 7 |       <span class="fa fa-caret-down"></span>
 8 |     </span>
 9 |     <div class="rst-other-versions">
10 |       <dl>
11 |         <dt>{{ _('Versions') }}</dt>
12 |         {% for slug, url in versions %}
13 |           <dd><a href="{{ url }}">{{ slug }}</a></dd>
14 |         {% endfor %}
15 |       </dl>
16 |       <dl>
17 |         <dt>{{ _('Downloads') }}</dt>
18 |         {% for type, url in downloads %}
19 |           <dd><a href="{{ url }}">{{ type }}</a></dd>
20 |         {% endfor %}
21 |       </dl>
22 |       <dl>
23 |         <dt>{{ _('On Read the Docs') }}</dt>
24 |           <dd>
25 |             <a href="//{{ PRODUCTION_DOMAIN }}/projects/{{ slug }}/?fromdocs={{ slug }}">{{ _('Project Home') }}</a>
26 |           </dd>
27 |           <dd>
28 |             <a href="//{{ PRODUCTION_DOMAIN }}/builds/{{ slug }}/?fromdocs={{ slug }}">{{ _('Builds') }}</a>
29 |           </dd>
30 |       </dl>
31 |       <hr/>
32 |       {% trans %}Free document hosting provided by <a href="http://www.readthedocs.org">Read the Docs</a>.{% endtrans %}
33 | 
34 |     </div>
35 |   </div>
36 | {% endif %}
37 | 
38 | 


--------------------------------------------------------------------------------
/theme/sphinx_rtd_theme/search.html:
--------------------------------------------------------------------------------
 1 | {#
 2 |     basic/search.html
 3 |     ~~~~~~~~~~~~~~~~~
 4 | 
 5 |     Template for the search page.
 6 | 
 7 |     :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
 8 |     :license: BSD, see LICENSE for details.
 9 | #}
10 | {%- extends "layout.html" %}
11 | {% set title = _('Search') %}
12 | {% set script_files = script_files + ['_static/searchtools.js'] %}
13 | {% block footer %}
14 |   <script type="text/javascript">
15 |     jQuery(function() { Search.loadIndex("{{ pathto('searchindex.js', 1) }}"); });
16 |   </script>
17 |   {# this is used when loading the search index using $.ajax fails,
18 |      such as on Chrome for documents on localhost #}
19 |   <script type="text/javascript" id="searchindexloader"></script>
20 |   {{ super() }}
21 | {% endblock %}
22 | {% block body %}
23 |   <noscript>
24 |   <div id="fallback" class="admonition warning">
25 |     <p class="last">
26 |       {% trans %}Please activate JavaScript to enable the search
27 |       functionality.{% endtrans %}
28 |     </p>
29 |   </div>
30 |   </noscript>
31 | 
32 |   {% if search_performed %}
33 |     <h2>{{ _('Search Results') }}</h2>
34 |     {% if not search_results %}
35 |       <p>{{ _('Your search did not match any documents. Please make sure that all words are spelled correctly and that you\'ve selected enough categories.') }}</p>
36 |     {% endif %}
37 |   {% endif %}
38 |   <div id="search-results">
39 |   {% if search_results %}
40 |     <ul>
41 |     {% for href, caption, context in search_results %}
42 |       <li>
43 |         <a href="{{ pathto(item.href) }}">{{ caption }}</a>
44 |         <p class="context">{{ context|e }}</p>
45 |       </li>
46 |     {% endfor %}
47 |     </ul>
48 |   {% endif %}
49 |   </div>
50 | {% endblock %}
51 | 


--------------------------------------------------------------------------------
/formats.rst:
--------------------------------------------------------------------------------
 1 | .. highlight:: rst
 2 | 
 3 | ################
 4 | 影像是什么
 5 | ################
 6 | 从真实世界中获取数字影像有很多方法，比如数码相机、扫描仪、CT或者磁共振成像。无论哪种方法，我们（人类）看到的是影像，而让数字设备来“看“的时候，则是在记录影像中的每一个点的数值。 [#f1]_  
 7 | 
 8 | .. image:: img/cameraman.png
 9 |    :alt: A matrix of the mirror of cameraman
10 |    :align: center
11 | 
12 | 比如上面的影像，在标出的蓝框中你见到的只是一块灰色区域，但是计算机中识别为一个矩阵，该矩阵包含了所有像素点的强度值。如何获取并存储这些像素值由我们的需求而定，最终在计算机世界里所有影像都可以简化矩阵信息。当然，影像还有其他信息，下面我们即将介绍。
13 | 
14 | ******************
15 | 影像元数据
16 | ******************
17 | 影像元数据是指影像中除了信息矩阵以外的一些参考数据。例如影像的长、宽、波段数、数据类型、存储方式、投影坐标、太阳高度角、获取时间、传感器信息等内容。使用 :ref:`gdalinfo` ，我们就可以看到影像的元数据信息：
18 | 
19 | .. figure:: img/metaData.png
20 |    :alt: multiBands Image
21 |    :align: center
22 | 
23 | 
24 | ******************   
25 | GDAL中的影像
26 | ******************
27 | GDAL中，影像也可以称为 :ref:`dataset` ，大致分为两种类型，多波段影像和多数据集影像。 :ref:`gdaldatamodel` 中我们将详细介绍GDAL对影像数据如何解析和读写，这章中，我们只简单的分析一下两种数据的共性和区别。
28 | 
29 | .. _multibands:
30 | 
31 | 多波段数据
32 | ================
33 | 多波段数据是我们比较熟悉的，例如tiff格式、jpg格式、png格式、img格式等，都是多个波段的数据。我们一般处理的也都是多波段的数据。
34 | 
35 | 多波段的数据实际上可以看为一个二维的数组，在GDAL中就是包含了多个 :ref:`rasterband` 的一个 :ref:`dataset` ，里面保存了影像的所有数据以及元数据。其中数据存在 :ref:`rasterband` 中，每个波段可以当作一维数组进行处理。如下图所示：
36 | 
37 | .. figure:: img/multBands.png
38 |    :alt: multiBands Image
39 |    :align: center
40 | 
41 | 
42 | .. _multidatasets:
43 | 
44 | 多数据集数据
45 | ===============
46 | 这种数据遥感影像中也比较常见，例如hdf格式、he5格式、netcdf格式等。这些数据在GDAL中，与上文介绍的多波段数据不同，是包含了多个 :ref:`dataset` 的 :ref:`dataset` 。可以简单的理解为：一个多数据集数据包含了多个 :ref:`multibands` ，当然，实际上，这些 :ref:`multibands` 里大部分只有一个波段。如下图所示：
47 | 
48 | .. figure:: img/multDataset.png
49 |    :alt: multDataset Image
50 |    :align: center
51 | 
52 | 一般我们会将多数据集数据转化为多波段的数据，方便处理。下面就是一个多数据集数据转换为多波段数据的函数，其中的部分内容我们将在后文中陆续展开讲解：
53 | 
54 | .. literalinclude:: code/sub2tif.c
55 |     :language: c++
56 |     :encoding: utf8
57 | 
58 | .. [#f1] `来自OpenCV文档 <http://www.opencv.org.cn/opencvdoc/2.3.2/html/doc/tutorials/core/mat%20-%20the%20basic%20image%20container/mat%20-%20the%20basic%20image%20container.html#matthebasicimagecontainer>`_
59 | 


--------------------------------------------------------------------------------
/theme/sphinx_rtd_theme/footer.html:
--------------------------------------------------------------------------------
 1 | <footer>
 2 |   {% if (theme_prev_next_buttons_location == 'bottom' or theme_prev_next_buttons_location == 'both') and (next or prev) %}
 3 |     <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
 4 |       {% if next %}
 5 |         <a href="{{ next.link|e }}" class="btn btn-neutral float-right" title="{{ next.title|striptags|e }}" accesskey="n" rel="next">{{ _('Next') }} <span class="fa fa-arrow-circle-right"></span></a>
 6 |       {% endif %}
 7 |       {% if prev %}
 8 |         <a href="{{ prev.link|e }}" class="btn btn-neutral" title="{{ prev.title|striptags|e }}" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> {{ _('Previous') }}</a>
 9 |       {% endif %}
10 |     </div>
11 |   {% endif %}
12 | 
13 |   <hr/>
14 | 
15 |   <div role="contentinfo">
16 |     <p>
17 |     {%- if show_copyright %}
18 |       {%- if hasdoc('copyright') %}
19 |         {% trans path=pathto('copyright'), copyright=copyright|e %}&copy; <a href="{{ path }}">Copyright</a> {{ copyright }}.{% endtrans %}
20 |       {%- else %}
21 |         {% trans copyright=copyright|e %}&copy; Copyright {{ copyright }}.{% endtrans %}
22 |       {%- endif %}
23 |     {%- endif %}
24 | 
25 |     {%- if build_id and build_url %}
26 |       {% trans build_url=build_url, build_id=build_id %}
27 |         <span class="build">
28 |           Build
29 |           <a href="{{ build_url }}">{{ build_id }}</a>.
30 |         </span>
31 |       {% endtrans %}
32 |     {%- elif commit %}
33 |       {% trans commit=commit %}
34 |         <span class="commit">
35 |           Revision <code>{{ commit }}</code>.
36 |         </span>
37 |       {% endtrans %}
38 |     {%- elif last_updated %}
39 |       {% trans last_updated=last_updated|e %}Last updated on {{ last_updated }}.{% endtrans %}
40 |     {%- endif %}
41 | 
42 |     </p>
43 |   </div>
44 | 
45 |   {%- if show_sphinx %}
46 |   {% trans %}Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>{% endtrans %}.
47 |   {%- endif %}
48 | 
49 |   {%- block extrafooter %} {% endblock %}
50 | 
51 | </footer>
52 | 
53 | 


--------------------------------------------------------------------------------
/theme/sphinx_rtd_theme/static/css/badge_only.css:
--------------------------------------------------------------------------------
1 | .fa:before{-webkit-font-smoothing:antialiased}.clearfix{*zoom:1}.clearfix:before,.clearfix:after{display:table;content:""}.clearfix:after{clear:both}@font-face{font-family:FontAwesome;font-weight:normal;font-style:normal;src:url("../fonts/fontawesome-webfont.eot");src:url("../fonts/fontawesome-webfont.eot?#iefix") format("embedded-opentype"),url("../fonts/fontawesome-webfont.woff") format("woff"),url("../fonts/fontawesome-webfont.ttf") format("truetype"),url("../fonts/fontawesome-webfont.svg#FontAwesome") format("svg")}.fa:before{display:inline-block;font-family:FontAwesome;font-style:normal;font-weight:normal;line-height:1;text-decoration:inherit}a .fa{display:inline-block;text-decoration:inherit}li .fa{display:inline-block}li .fa-large:before,li .fa-large:before{width:1.875em}ul.fas{list-style-type:none;margin-left:2em;text-indent:-0.8em}ul.fas li .fa{width:.8em}ul.fas li .fa-large:before,ul.fas li .fa-large:before{vertical-align:baseline}.fa-book:before{content:""}.icon-book:before{content:""}.fa-caret-down:before{content:""}.icon-caret-down:before{content:""}.fa-caret-up:before{content:""}.icon-caret-up:before{content:""}.fa-caret-left:before{content:""}.icon-caret-left:before{content:""}.fa-caret-right:before{content:""}.icon-caret-right:before{content:""}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;z-index:400}.rst-versions a{color:#2980B9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27AE60;*zoom:1}.rst-versions .rst-current-version:before,.rst-versions .rst-current-version:after{display:table;content:""}.rst-versions .rst-current-version:after{clear:both}.rst-versions .rst-current-version .fa{color:#fcfcfc}.rst-versions .rst-current-version .fa-book{float:left}.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#E74C3C;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#F1C40F;color:#000}.rst-versions.shift-up{height:auto;max-height:100%}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:gray;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:solid 1px #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px}.rst-versions.rst-badge .icon-book{float:none}.rst-versions.rst-badge .fa-book{float:none}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book{float:left}.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge .rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width: 768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}}
2 | 


--------------------------------------------------------------------------------
/theme/sphinx_rtd_theme/breadcrumbs.html:
--------------------------------------------------------------------------------
 1 | {# Support for Sphinx 1.3+ page_source_suffix, but don't break old builds. #}
 2 | 
 3 | {% if page_source_suffix %}
 4 | {% set suffix = page_source_suffix %}
 5 | {% else %}
 6 | {% set suffix = source_suffix %}
 7 | {% endif %}
 8 | 
 9 | {% if meta is defined and meta is not none %}
10 | {% set check_meta = True %}
11 | {% else %}
12 | {% set check_meta = False %}
13 | {% endif %}
14 | 
15 | {% if check_meta and 'github_url' in meta %}
16 | {% set display_github = True %}
17 | {% endif %}
18 | 
19 | {% if check_meta and 'bitbucket_url' in meta %}
20 | {% set display_bitbucket = True %}
21 | {% endif %}
22 | 
23 | {% if check_meta and 'gitlab_url' in meta %}
24 | {% set display_gitlab = True %}
25 | {% endif %}
26 | 
27 | <div role="navigation" aria-label="breadcrumbs navigation">
28 | 
29 |   <ul class="wy-breadcrumbs">
30 |     {% block breadcrumbs %}
31 |       <li><a href="{{ pathto(master_doc) }}">{{ _('Docs') }}</a> &raquo;</li>
32 |         {% for doc in parents %}
33 |           <li><a href="{{ doc.link|e }}">{{ doc.title }}</a> &raquo;</li>
34 |         {% endfor %}
35 |       <li>{{ title }}</li>
36 |     {% endblock %}
37 |     {% block breadcrumbs_aside %}
38 |       <li class="wy-breadcrumbs-aside">
39 |         {% if hasdoc(pagename) %}
40 |             {% if display_github %}
41 |             {% if check_meta and 'github_url' in meta %}
42 |               <!-- User defined GitHub URL -->
43 |               <a href="{{ meta['github_url'] }}" class="fa fa-github"> {{ _('Edit on GitHub') }}</a>
44 |             {% else %}
45 |               <a href="https://{{ github_host|default("github.com") }}/{{ github_user }}/{{ github_repo }}/{{ theme_vcs_pageview_mode|default("blob") }}/{{ github_version }}{{ conf_py_path }}{{ pagename }}{{ suffix }}" class="fa fa-github"> {{ _('Edit on GitHub') }}</a>
46 |             {% endif %}
47 |           {% elif display_bitbucket %}
48 |             {% if check_meta and 'bitbucket_url' in meta %}
49 |               <!-- User defined Bitbucket URL -->
50 |               <a href="{{ meta['bitbucket_url'] }}" class="fa fa-bitbucket"> {{ _('Edit on Bitbucket') }}</a>
51 |             {% else %}
52 |               <a href="https://bitbucket.org/{{ bitbucket_user }}/{{ bitbucket_repo }}/src/{{ bitbucket_version}}{{ conf_py_path }}{{ pagename }}{{ suffix }}?mode={{ theme_vcs_pageview_mode|default("view") }}" class="fa fa-bitbucket"> {{ _('Edit on Bitbucket') }}</a>
53 |             {% endif %}
54 |           {% elif display_gitlab %}
55 |             {% if check_meta and 'gitlab_url' in meta %}
56 |               <!-- User defined GitLab URL -->
57 |               <a href="{{ meta['gitlab_url'] }}" class="fa fa-gitlab"> {{ _('Edit on GitLab') }}</a>
58 |             {% else %}
59 |               <a href="https://{{ gitlab_host|default("gitlab.com") }}/{{ gitlab_user }}/{{ gitlab_repo }}/{{ theme_vcs_pageview_mode|default("blob") }}/{{ gitlab_version }}{{ conf_py_path }}{{ pagename }}{{ suffix }}" class="fa fa-gitlab"> {{ _('Edit on GitLab') }}</a>
60 |             {% endif %}
61 |           {% elif show_source and source_url_prefix %}
62 |             <a href="{{ source_url_prefix }}{{ pagename }}{{ suffix }}">{{ _('View page source') }}</a>
63 |           {% elif show_source and has_source and sourcename %}
64 |             <a href="{{ pathto('_sources/' + sourcename, true)|e }}" rel="nofollow"> {{ _('View page source') }}</a>
65 |           {% endif %}
66 |         {% endif %}
67 |       </li>
68 |     {% endblock %}
69 |   </ul>
70 | 
71 |   {% if (theme_prev_next_buttons_location == 'top' or theme_prev_next_buttons_location == 'both') and (next or prev) %}
72 |   <div class="rst-breadcrumbs-buttons" role="navigation" aria-label="breadcrumb navigation">
73 |       {% if next %}
74 |         <a href="{{ next.link|e }}" class="btn btn-neutral float-right" title="{{ next.title|striptags|e }}" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
75 |       {% endif %}
76 |       {% if prev %}
77 |         <a href="{{ prev.link|e }}" class="btn btn-neutral" title="{{ prev.title|striptags|e }}" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
78 |       {% endif %}
79 |   </div>
80 |   {% endif %}
81 |   <hr/>
82 | </div>
83 | 


--------------------------------------------------------------------------------
/theme/sphinx_rtd_theme/static/js/theme.js:
--------------------------------------------------------------------------------
1 | /* sphinx_rtd_theme version 0.4.1 | MIT license */
2 | /* Built 20180727 10:07 */
3 | require=function n(e,i,t){function o(s,a){if(!i[s]){if(!e[s]){var l="function"==typeof require&&require;if(!a&&l)return l(s,!0);if(r)return r(s,!0);var c=new Error("Cannot find module '"+s+"'");throw c.code="MODULE_NOT_FOUND",c}var u=i[s]={exports:{}};e[s][0].call(u.exports,function(n){var i=e[s][1][n];return o(i||n)},u,u.exports,n,e,i,t)}return i[s].exports}for(var r="function"==typeof require&&require,s=0;s<t.length;s++)o(t[s]);return o}({"sphinx-rtd-theme":[function(n,e,i){var jQuery="undefined"!=typeof window?window.jQuery:n("jquery");e.exports.ThemeNav={navBar:null,win:null,winScroll:!1,winResize:!1,linkScroll:!1,winPosition:0,winHeight:null,docHeight:null,isRunning:!1,enable:function(n){var e=this;void 0===n&&(n=!0),e.isRunning||(e.isRunning=!0,jQuery(function(i){e.init(i),e.reset(),e.win.on("hashchange",e.reset),n&&e.win.on("scroll",function(){e.linkScroll||e.winScroll||(e.winScroll=!0,requestAnimationFrame(function(){e.onScroll()}))}),e.win.on("resize",function(){e.winResize||(e.winResize=!0,requestAnimationFrame(function(){e.onResize()}))}),e.onResize()}))},enableSticky:function(){this.enable(!0)},init:function(n){n(document);var e=this;this.navBar=n("div.wy-side-scroll:first"),this.win=n(window),n(document).on("click","[data-toggle='wy-nav-top']",function(){n("[data-toggle='wy-nav-shift']").toggleClass("shift"),n("[data-toggle='rst-versions']").toggleClass("shift")}).on("click",".wy-menu-vertical .current ul li a",function(){var i=n(this);n("[data-toggle='wy-nav-shift']").removeClass("shift"),n("[data-toggle='rst-versions']").toggleClass("shift"),e.toggleCurrent(i),e.hashChange()}).on("click","[data-toggle='rst-current-version']",function(){n("[data-toggle='rst-versions']").toggleClass("shift-up")}),n("table.docutils:not(.field-list,.footnote,.citation)").wrap("<div class='wy-table-responsive'></div>"),n("table.docutils.footnote").wrap("<div class='wy-table-responsive footnote'></div>"),n("table.docutils.citation").wrap("<div class='wy-table-responsive citation'></div>"),n(".wy-menu-vertical ul").not(".simple").siblings("a").each(function(){var i=n(this);expand=n('<span class="toctree-expand"></span>'),expand.on("click",function(n){return e.toggleCurrent(i),n.stopPropagation(),!1}),i.prepend(expand)})},reset:function(){var n=encodeURI(window.location.hash)||"#";try{var e=$(".wy-menu-vertical"),i=e.find('[href="'+n+'"]');if(0===i.length){var t=$('.document [id="'+n.substring(1)+'"]').closest("div.section");0===(i=e.find('[href="#'+t.attr("id")+'"]')).length&&(i=e.find('[href="#"]'))}i.length>0&&($(".wy-menu-vertical .current").removeClass("current"),i.addClass("current"),i.closest("li.toctree-l1").addClass("current"),i.closest("li.toctree-l1").parent().addClass("current"),i.closest("li.toctree-l1").addClass("current"),i.closest("li.toctree-l2").addClass("current"),i.closest("li.toctree-l3").addClass("current"),i.closest("li.toctree-l4").addClass("current"))}catch(o){console.log("Error expanding nav for anchor",o)}},onScroll:function(){this.winScroll=!1;var n=this.win.scrollTop(),e=n+this.winHeight,i=this.navBar.scrollTop()+(n-this.winPosition);n<0||e>this.docHeight||(this.navBar.scrollTop(i),this.winPosition=n)},onResize:function(){this.winResize=!1,this.winHeight=this.win.height(),this.docHeight=$(document).height()},hashChange:function(){this.linkScroll=!0,this.win.one("hashchange",function(){this.linkScroll=!1})},toggleCurrent:function(n){var e=n.closest("li");e.siblings("li.current").removeClass("current"),e.siblings().find("li.current").removeClass("current"),e.find("> ul li.current").removeClass("current"),e.toggleClass("current")}},"undefined"!=typeof window&&(window.SphinxRtdTheme={Navigation:e.exports.ThemeNav,StickyNav:e.exports.ThemeNav}),function(){for(var n=0,e=["ms","moz","webkit","o"],i=0;i<e.length&&!window.requestAnimationFrame;++i)window.requestAnimationFrame=window[e[i]+"RequestAnimationFrame"],window.cancelAnimationFrame=window[e[i]+"CancelAnimationFrame"]||window[e[i]+"CancelRequestAnimationFrame"];window.requestAnimationFrame||(window.requestAnimationFrame=function(e,i){var t=(new Date).getTime(),o=Math.max(0,16-(t-n)),r=window.setTimeout(function(){e(t+o)},o);return n=t+o,r}),window.cancelAnimationFrame||(window.cancelAnimationFrame=function(n){clearTimeout(n)})}()},{jquery:"jquery"}]},{},["sphinx-rtd-theme"]);


--------------------------------------------------------------------------------
/preface.rst:
--------------------------------------------------------------------------------
  1 | ################
  2 | 前言
  3 | ################
  4 | O'Reilly有一个HeadFirst系列，面对完全的初学者的书籍。因为经常用到GDAL，也碰到过一些问题，所以从头开始，写一些经验，给大家分享。网上也有许多GDAL的文章，除了李民录老师写的，大部分不太系统，虽然有系统文档，但都是英文的，很多人都不想看，因此写这个文档，算是总结，也帮新手少走点弯路。本系列主要涉及的是GDAL的各个接口和调用，以及一些基础概念的阐述，不涉及其他应用方面，GDAL更新也比较快，所以本文也只能介绍主要的读写接口以及GDALWarp部分，不涉及更深入的内容。如果想学好，推荐还是认真阅读英文文档。
  5 | 
  6 | 本文主要注重于栅格影像处理，矢量ogr库暂时没有涉及（以后可能会添加），主要使用 c++ 语言，vs2010 或 vc6 平台下使用。
  7 | 
  8 | ******************
  9 | GDAL是什么
 10 | ******************
 11 | GDAL 是 ``Geospatial Data Abstraction Library`` 的缩写，是一个在X/MIT许可协议下的开源栅格空间数据转换库。它利用抽象数据模型来表达所支持的各种文件格式。它还有一系列命令行工具来进行数据转换和处理。OGR是GDAL项目的一个分支，功能与GDAL类似，只不过它提供对矢量数据的支持。
 12 | 
 13 | 有很多著名的GIS类产品都使用了GDAL/OGR库，包括ESRI的ArgGIS平台，Google Earth和跨平台的GRASS GIS系统。
 14 | 
 15 | ******************
 16 | GDAL能做什么
 17 | ******************
 18 | GDAL可以用来对各种栅格数据格式进行读写，也可以用于格式相互转换，图像几何校正、重投影、重采样等。
 19 | 
 20 | GDAL中包括很多算法，比如surf匹配算法，TPS纠正等几何纠正算法，OGR库中也可以进行拓扑运算，因为是开源的，所以部分算法可以参照源码，如TPS中矩阵运算可以添加Aramdillo库，匹配算法也可以借鉴学习。
 21 | 
 22 | ******************
 23 | 参考文档
 24 | ******************
 25 | 文档参考的文章和示例来自以下位置：
 26 | 
 27 | * `GDAL源文档 <http://www.gdal.org>`_
 28 | * `李民录GDAL专栏 <http://blog.csdn.net/liminlu0314?viewmode=contents>`_
 29 | * `WKT <http://www.geoapi.org/3.0/javadoc/org/opengis/referencing/doc-files/WKT.html>`_ 
 30 | * `地图投影系列介绍 <http://blog.sina.com.cn/s/blog_7f6303470101fzcw.html>`_ 
 31 | * `地图投影简明笔记 <http://www.cnblogs.com/yiyezhai/p/3182955.html>`_ 
 32 | 
 33 | ******************
 34 | 如何使用GDAL库
 35 | ******************
 36 | 很多新手不知道下载的编译完成的库如何使用，下面以vc6和vs2010中如何使用为例，给大家讲解下。本部分参照 `GDAL源码剖析（六）之GDAL开发及其调试 <http://blog.csdn.net/liminlu0314/article/details/7072007>`_ ,其中讲的已经比较清楚,本段简单介绍下载或编译完成的库如何使用。
 37 | 
 38 | .. note::
 39 | 
 40 |     * 如果不关心如何编译调试GDAL的话，可以直接使用 `框架 <http://pan.baidu.com/s/1oqGwu>`_ ,里面有已经设置好的环境和基础的两影像相加的示例.
 41 |     * 没有C++基础的新手，推荐阅读下 `C++静态库与动态库 <http://www.cnblogs.com/skynet/p/3372855.html>`_ ，对库的解说比较好.
 42 | 
 43 | 目录说明
 44 | ================
 45 | 下载完成的GDAL库，一般有 ``lib include html data bin`` 几个文件夹，这些是必须文件，其他有些是调试或绑定其他语言用的文件夹 ,下面分别介绍其作用:
 46 | 
 47 | * lib       里面包含 gdal_i.lib 库文件
 48 | * include   包含头文件
 49 | * html      包含html文档说明
 50 | * data      包含GDAL的数据文件，例如epsg文件、dxf头文件、S-57 定义文件等，可以设置 ``GDAL_DATA`` 环境变量来改变其路径
 51 | * bin       工具集，包括一个dll文件。
 52 | 
 53 | 安装
 54 | ================
 55 | 新建工程，在新建工程中添加 ``GDAL`` 目录，将上述文件夹中的 ``lib include`` 文件夹拷贝到新建的 ``GDAL`` 目录中，至此完成安装。
 56 | 
 57 | .. attention::
 58 | 
 59 |     * 也可以在工程设置中设置所在路径，本步骤并非必须步骤，仅为了方便下面介绍以及新手理解
 60 | 
 61 | 工程设置
 62 | ================
 63 | vc6
 64 | -------------------
 65 | 打开或新建vc6工程，在菜单中找到工程->设置(Project->Settings)，如下所示：
 66 | 
 67 | .. image:: img/vc6setting.png
 68 |    :alt: vc6 project setting
 69 |    :align: center
 70 | 
 71 | 设置Include路径，点击 ``c++`` Tab页,在 ``Category`` 中选择 ``Preprocessor``,第三项,添加Include目录中,添加gdal的include文件夹路径:
 72 | 
 73 | .. image:: img/vc6Include.png
 74 |    :alt: vc6 include setting
 75 |    :align: center
 76 | 
 77 | 设置Lib路径,点击 ``Link`` Tab页,在 ``Category`` 中,选择 ``Input`` ,第一项中填入 ``gdal_i.lib`` ,第四项中添加gdal中的lib文件夹路径：
 78 | 
 79 | .. image:: img/vc6Link.png
 80 |    :alt: vc6 link setting
 81 |    :align: center
 82 | 
 83 | .. attention::
 84 | 
 85 | 	* 编译完成后，需要将 ``bin`` 或者 ``lib`` 文件夹下面的DLL文件全部拷贝到输出目录中（Debug或Release文件夹中）
 86 | 
 87 | vs2010
 88 | -------------------
 89 | 打开或新建vs工程，右键设置项目属性，如下所示：
 90 | 
 91 | .. image:: img/vs2010setting.png
 92 |    :alt: vc6 project setting
 93 |    :align: center
 94 | 
 95 | 设置Include路径，点击 ``C++`` 填写第一项，在附加包含目录中添加gdal的Include文件夹路径：
 96 | 
 97 | .. image:: img/vs2010Include.png
 98 |    :alt: vc6 include setting
 99 |    :align: center
100 | 
101 | 设置Lib路径,点击 ``链接器`` ,在 ``常规`` 中, ``附加库目录`` 里添加gdal中的lib文件夹路径：
102 | 
103 | .. image:: img/vs2010Link1.png
104 |    :alt: vc6 link setting
105 |    :align: center
106 | 
107 | 设置Lib库，点击 ``链接器`` ,在 ``输入`` 中, ``附加依赖项`` 里添加填入 ``gdal_i.lib``：
108 | 
109 | .. image:: img/vs2010Link2.png
110 |    :alt: vc6 link setting
111 |    :align: center
112 | 
113 | .. attention::
114 | 
115 | 	* 编译完成后，需要将 ``bin`` 或者 ``lib`` 文件夹下面的DLL文件全部拷贝到输出目录中（Debug或Release文件夹中）
116 | 
117 | 这样就完成了环境设置，接下来就可以按照  :ref:`read&write`  的例子读写数据了。
118 | 
119 | vcpkg
120 | -------------------
121 | 现在在windows下,可以使用vcpkg安装gdal,已经更新至vs2017了
122 | 
123 | 使用方式:
124 | 
125 | 1. 安装 `vcpkg`,可以参考 `vcpkg包管理工具 <https://blog.csdn.net/hhy321/article/details/120595738>`_ 一文,进行安装和配置
126 | 2. 打开windows的`cmd`或者`powershell`,先 cd 到vcpkg安装目录下,然后输入`.\vcpkg.exe install gdal`进行安装
127 | 
128 | ***********************
129 | OGR库说明
130 | ***********************
131 | 现在仅初步使用 ``OGR`` 库，大部分只是翻译文档,没有深入使用，有些翻译并不准确。如有不确定的地方，请参照文档。在 ``GDAL2.0`` 中， ``OGR`` 库和 ``GDAL`` 库的数据集已经合并，其他部分基本没变，现已加入2.0内容,3.0的读写跟2.0一致,没有单独添加。
132 | 
133 | 
134 | ***********************
135 | 使用的工具
136 | ***********************
137 | 文档使用 ``sphinx`` 编写，演示图片使用 `Pencil <http://pencil.evolus.vn>`_ 绘制。pdf使用TexLive2013生成。
138 | 
139 | 


--------------------------------------------------------------------------------
/gdal-alg.rst:
--------------------------------------------------------------------------------
  1 | .. highlight:: rst
  2 | .. _gdalalgs:
  3 | 
  4 | ############################
  5 | GDAL算法简介
  6 | ############################
  7 | 
  8 | 主要来自 `GDAL RelatePages <https://www.gdal.org/pages.html>`_ 等 ,对部分翻译进行了少量修改和更新。暂时只介绍几种用过的算法,以后再加。
  9 | 
 10 | ********************
 11 | GDAL网格插值
 12 | ********************
 13 | 主要来自 `GDAL Grid Tutorial <https://www.gdal.org/grid_tutorial.html>`_ 
 14 | 
 15 | 想要了解插值算法可以看 `GDAL源码剖析（十三）之GDAL网格插值说明 <https://blog.csdn.net/liminlu0314/article/details/7654279>`_ ,基本是对GDAL文档的翻译
 16 | 
 17 | 这里就直接介绍如何使用, ``GDAL`` 里网格插值算法有两大类,使用数据指标或者插值算法,数据指标用的是搜索椭圆内的点的数据指标来算,另一种就是根据离散点插值,有反距离权重等方式.
 18 | 
 19 | 插值方式有三种:
 20 | 
 21 |     1. 直接使用函数 ``GDALGridCreate`` 创建
 22 |     2. 使用 ``GDALGridContextCreate`` ``GDALGridContextProcess`` 和 ``GDALGridContextFree`` ,使用重复参数批量生成插值时,这种方式效率较高
 23 |     3. 使用工具方式调用 ``GDALGrid`` 创建,详情见 :ref:`GDALUtilitiesWithCode` 部分,此处不再赘述
 24 |     
 25 | 参数比较简单,就不翻译了,直接看代码:
 26 | 
 27 | 方式一
 28 | =============
 29 | 
 30 | .. code-block:: c++
 31 | 
 32 |     std::vector<double> padfX;
 33 |     std::vector<double> padfY;
 34 |     std::vector<double> padfZ;
 35 |     //TODO: 添加x,y,z离散点,请自行修改
 36 |     ...
 37 |     //END
 38 |     //算最值
 39 |     std::vector<double>::iterator it = std::min_element(padfX.begin(), padfX.end());
 40 |     double  dfXMin = *it;
 41 |     it = std::max_element(padfX.begin(), padfX.end());
 42 |     double  dfXMax = *it;
 43 |     it = std::min_element(padfY.begin(), padfY.end());
 44 |     double  dfYMin = *it;
 45 |     it = std::max_element(padfY.begin(), padfY.end());
 46 |     double  dfYMax = *it;
 47 |     // 离散点内插方法
 48 |     //Linear 先构建Delaunay 三角网,然后用三角网插值,插值速度较快,速度仅与构网的离散点数量有关
 49 |     //无论是何种方式内插,都需要构建Options
 50 |     //插值算法有对应的Option结构体,数据指标(Data Metric)用的是统一的结构体 GDALGridDataMetricsOptions
 51 |     GDALGridLinearOptions  *poOptions = new GDALGridLinearOptions();
 52 |     poOptions->dfNoDataValue = -9999;
 53 |     poOptions->dfRadius = 0;
 54 |     
 55 |     //构建GRID
 56 |     double *pGridData  =  new double[nWidth*nHeight];
 57 |     GDALGridCreate(GGA_Linear ,poOptions,padfX.size(),&(padfX[0]),&(padfY[0]),&(padfZ[0]),\
 58 |         dfXMin, dfXMax, dfYMin, dfYMax, nWidth, nHeight, GDT_Float64, pGridData, NULL, NULL);
 59 |     delete poOptions;
 60 |     //处理生成的grid
 61 |     ...
 62 |     delete[] pGridData;
 63 | 
 64 | 方式二
 65 | =============
 66 | 
 67 | .. code-block:: c++
 68 | 
 69 |     GDALGridLinearOptions  *poOptions = new GDALGridLinearOptions();
 70 |     poOptions->dfNoDataValue = -9999;
 71 |     poOptions->dfRadius = 0;
 72 |     //构建GRID
 73 |     double *pGridData  =  new double[nWidth*nHeight];
 74 |     GDALGridContext* context = GDALGridContextCreate(GGA_Linear,poOptions,padfX.size(),&(padfX[0]),&(padfY[0]),&(padfZ[0]),gwFALSE);
 75 |     GDALGridContextProcess(context,dfXMin, dfXMax, dfYMin, dfYMax,nWidth, nHeight, GDT_Float64,pGridData, NULL, NULL);
 76 |     GDALGridContextFree(context);
 77 |     //处理生成的grid
 78 |     ...
 79 |     delete[] pGridData;
 80 |     delete poOptions;
 81 | 
 82 | 
 83 | .. warning::
 84 | 
 85 |     * 2.2.3以下的版本中, 网格插值使用 ``GGA_Linear`` 方法可能会崩溃,在2.2.3中修复,可以直接修改源码,可按照
 86 |       `GDALGrid() with linear algorithm: avoid assertions/segmentation fault… <https://github.com/OSGeo/gdal/commit/ea2627dc5205e30d3463c64718c3bd147ce0b8c0#diff-62b56095c6ca3aa65387c3b8d95808f9>`_ 
 87 |       中的代码修改
 88 | 
 89 |     
 90 | ****************************************
 91 |  GDAL栅格化
 92 | ****************************************
 93 | 主要来自 `gdal_alg.h File Reference <https://www.gdal.org/gdal__alg_8h.html>`_
 94 | 
 95 | 栅格化三个函数类似, ``GDALRasterizeLayers  GDALRasterizeGeometries GDALRasterizeLayersBuf`` 需要注意的参数只有     ``padfGeomBurnValue`` 或者 ``dfBurnValue``
 96 | 这个参数是矢量栅格化后的具体值,可以设置为栅格值
 97 | 
 98 | .. code-block:: c++
 99 | 
100 |     GDALDataset* outDS;
101 |     //创建outDS
102 |     ...
103 |     std::vector<OGRGeometryH> ahGeometries;
104 |     std::vector<double> adfFullBurnValues;
105 |     //加入各个几何形状和各个几何形状对应的值
106 |     //adfFullBurnValues个数为对应ahGeometries乘以波段数,每个波段都需要设置值
107 | 
108 |     ahGeometries.push_back((OGRGeometryH)OgrPolygon);
109 |     adfFullBurnValues.push_back(1);
110 |     //几何变换参数,可以参照wrap
111 |     void * hGenTransformArg=NULL;
112 |     hGenTransformArg = GDALCreateGenImgProjTransformer( NULL,
113 |         NULL,
114 |         (GDALDatasetH)outDS,
115 |         outDS->GetProjectionRef(),
116 |         false, 0, 3 );
117 |     CPLErr err = GDALRasterizeGeometries((GDALDatasetH)outDS,
118 |                                         1,
119 |                                         pnbandlist,
120 |                                         ahGeometries.size(),&(ahGeometries[0]),
121 |                                         GDALGenImgProjTransform,
122 |                                         hGenTransformArg,
123 |                                         &(adfFullBurnValues[0]),
124 |                                         papszOptions, NULL, NULL);
125 |     GDALDestroyGenImgProjTransformer(hGenTransformArg);
126 |     GDALClose(outDS);
127 | 
128 |     delete[]pnbandlist;
129 |     delete[]dburnValues;


--------------------------------------------------------------------------------
/code/gdalwarpsimple.c:
--------------------------------------------------------------------------------
  1 | /**
  2 | 图像坐标转地理坐标x
  3 |     @param geos   变换参数
  4 |     @param x      图像X坐标
  5 |     @param y      图像Y坐标
  6 |     @return       地理X坐标
  7 |  */
  8 | double Img2CoordX(const double *geos, double x, double y)
  9 | {
 10 |   return geos[0] + geos[1] * x + geos[2] * y;
 11 | }
 12 | /**
 13 | 图像坐标转地理坐标y
 14 |     @param geos   变换参数
 15 |     @param x      图像X坐标
 16 |     @param y      图像Y坐标
 17 |     @return       地理Y坐标
 18 |  */
 19 | double Img2CoordY(const double *geos, double x, double y)
 20 | {
 21 |   return geos[3] + geos[4] * x + geos[5] * y;
 22 | }
 23 | 
 24 | /**
 25 |     图像重采样
 26 |     @param InFile       输入文件
 27 |     @param OutFile      输出文件
 28 |     @param fResX        x分辨率
 29 |     @param fResY        Y分辨率
 30 |     @param iResampleAlg 重采样方式,默认为2
 31 |                             GRA_NearestNeighbour=0,
 32 |                             GRA_Bilinear=1,
 33 |                             GRA_Cubic=2,
 34 |                             GRA_CubicSpline=3,
 35 |                             GRA_Lanczos=4,
 36 |                             GRA_Average=5,
 37 |                             GRA_Mode=6
 38 |     @param pBandIndex   重采样的波段，默认为NULL，全部波段重采样
 39 |     @param pnBandCount   重采样波段总数，默认为0 ，全部波段重采样
 40 | */
 41 | int Resample(const char *InFile , const char *OutFile, float fResX ,
 42 |              float fResY, int iResampleAlg, int *pBandIndex, int pnBandCount)
 43 | {
 44 |   GDALAllRegister();
 45 |   GDALResampleAlg eResample = (GDALResampleAlg)iResampleAlg;
 46 |   //打开文件
 47 |   GDALDataset *pDSrc = (GDALDataset *)GDALOpen(InFile, GA_ReadOnly);
 48 | 
 49 |   if(pDSrc == NULL) {
 50 |     return -1;
 51 |   }
 52 | 
 53 |   GDALDriver *pDriver = GetGDALDriverManager()->GetDriverByName("GTiff");
 54 | 
 55 |   if(pDriver == NULL) {
 56 |     GDALClose((GDALDatasetH) pDSrc);
 57 |     return -2;
 58 |   }
 59 | 
 60 |   //计算输出投影参数
 61 |   int inBandCount = pDSrc->GetRasterCount();
 62 |   const char *strWkt = pDSrc->GetProjectionRef();
 63 |   GDALDataType dataType = pDSrc->GetRasterBand(1)->GetRasterDataType();
 64 |   double geos[6] = {0};
 65 |   pDSrc->GetGeoTransform(geos);
 66 |   double lefttopx = Img2CoordX(geos, 0, 0);
 67 |   double lefttopy = Img2CoordY(geos, 0, 0);
 68 |   int newWidth = (int) pDSrc->GetRasterXSize() * geos[1] / fResX;
 69 |   int newHeight = (int) fabs(pDSrc->GetRasterYSize() * geos[5] / fResY);
 70 |   geos[0] = lefttopx;
 71 |   geos[1] = fResX;
 72 |   geos[3] = lefttopy;
 73 |   geos[5] = -fResY;
 74 |   //输入输出波段对应
 75 |   int *pSrcBand = NULL;
 76 |   int *pDstBand = NULL;
 77 |   int iBandSize = 0;
 78 | 
 79 |   if(pBandIndex != NULL && pnBandCount != NULL) {
 80 |     iBandSize = pnBandCount;
 81 |     pSrcBand = new int[iBandSize];
 82 |     pDstBand = new int[iBandSize];
 83 | 
 84 |     for(int i = 0; i < iBandSize; i++) {
 85 |       pSrcBand[i] = pBandIndex[i];
 86 |       pDstBand[i] = i + 1;
 87 |     }
 88 |   } else {
 89 |     iBandSize = inBandCount;
 90 |     pSrcBand = new int[iBandSize];
 91 |     pDstBand = new int[iBandSize];
 92 | 
 93 |     for(int i = 0; i < iBandSize; i++) {
 94 |       pSrcBand[i] = i + 1;
 95 |       pDstBand[i] = i + 1;
 96 |     }
 97 |   }
 98 | 
 99 |   //创建输出文件
100 |   GDALDataset *pDDst = pDriver->Create(OutFile,
101 |                                        newWidth,
102 |                                        newHeight,
103 |                                        iBandSize,
104 |                                        dataType,
105 |                                        NULL);
106 |   pDDst->SetProjection(strWkt);
107 |   pDDst->SetGeoTransform(geos);
108 |   //参数选项
109 |   GDALWarpOptions *psWo = GDALCreateWarpOptions();
110 |   psWo->papszWarpOptions = CSLDuplicate(NULL);
111 |   //数据源
112 |   psWo->eWorkingDataType = dataType;
113 |   psWo->eResampleAlg = eResample;
114 |   psWo->hSrcDS = (GDALDatasetH) pDSrc;
115 |   psWo->hDstDS = (GDALDatasetH) pDDst;
116 |   //波段
117 |   psWo->nBandCount = iBandSize;
118 |   psWo->panSrcBands = (int *) CPLMalloc(iBandSize * sizeof(int));
119 |   psWo->panDstBands = (int *) CPLMalloc(iBandSize * sizeof(int));
120 | 
121 |   for(int i = 0; i < iBandSize; i++) {
122 |     psWo->panSrcBands[i] = pSrcBand[i];
123 |     psWo->panDstBands[i] = pDstBand[i];
124 |   }
125 | 
126 |   //变换函数设置
127 |   void *hTransformArg = NULL;
128 |   hTransformArg =  GDALCreateGenImgProjTransformer2(
129 |                      (GDALDatasetH) pDSrc,
130 |                      (GDALDatasetH) pDDst,
131 |                      NULL);
132 |   GDALTransformerFunc pFnTransformer = GDALGenImgProjTransform;
133 |   psWo->pfnTransformer = pFnTransformer;
134 |   psWo->pTransformerArg = hTransformArg;
135 |   //进度条
136 |   psWo->pfnProgress = GDALTermProgress;
137 |   //优化选项
138 |   psWo->dfWarpMemoryLimit = 512000000;
139 |   char **papszWarpOptions = NULL;
140 |   papszWarpOptions = CSLSetNameValue(papszWarpOptions, "NUM_THREADS", "ALL_CPUS");
141 |   papszWarpOptions = CSLSetNameValue(papszWarpOptions, "WRITE_FLUSH", "YES");
142 |   psWo->papszWarpOptions = papszWarpOptions;
143 |   //开始转换
144 |   GDALWarpOperation oWo;
145 | 
146 |   if(oWo.Initialize(psWo) != CE_None) {
147 |     GDALClose((GDALDatasetH) pDSrc);
148 |     GDALClose((GDALDatasetH) pDDst);
149 |     return -4;
150 |   }
151 | 
152 |   oWo.ChunkAndWarpMulti(0, 0, newWidth, newHeight);
153 |   //清理环境
154 |   GDALDestroyGenImgProjTransformer(psWo->pTransformerArg);
155 |   GDALDestroyWarpOptions(psWo);
156 |   GDALClose((GDALDatasetH) pDSrc);
157 |   GDALClose((GDALDatasetH) pDDst);
158 |   delete[] pSrcBand;
159 |   delete[] pDstBand;
160 |   return 0;
161 | }
162 | 


--------------------------------------------------------------------------------
/code/fullcode.c:
--------------------------------------------------------------------------------
  1 | #include "gdal_priv.h"
  2 | int main(int argc, char *argv[])
  3 | {
  4 |   GDALAllRegister();//注册类型，读取写入任何类型影像必须加入此句
  5 |   //以只读方式打开文件
  6 |   GDALDataset *ds1 = (GDALDataset *) GDALOpen("Input1.tif", GA_ReadOnly);
  7 | 
  8 |   if(ds1 == NULL) {
  9 |     printf("不能打开第一个文件，请检查文件是否存在！");
 10 |     return -1;
 11 |   }
 12 | 
 13 |   int WidthAll = ds1->GetRasterXSize();
 14 |   int HightAll = ds1->GetRasterYSize();
 15 |   int BandNum = ds1->GetRasterCount();
 16 |   float **InBuf1 = new float*[BandNum];
 17 |   int i, j, k;
 18 | 
 19 |   //分波段读取
 20 |   for(i = 0; i < BandNum; i++) {
 21 |     InBuf1[i] = new float[WidthAll * HightAll];
 22 |     GDALRasterBand *band = ds1->GetRasterBand(i + 1); //获取波段，波段从1开始
 23 |     band->RasterIO(GF_Read,
 24 |                    0,
 25 |                    0,
 26 |                    WidthAll,
 27 |                    HightAll,
 28 |                    InBuf1[i],
 29 |                    WidthAll,
 30 |                    HightAll,
 31 |                    GDT_Float32,
 32 |                    0,
 33 |                    0);
 34 |   }
 35 | 
 36 |   //打开第二个文件，假设第一个文件和第二个文件大小、波段数相同
 37 |   //以只读方式打开文件
 38 |   GDALDataset *ds2 = (GDALDataset *) GDALOpen("Input2.tif", GA_ReadOnly);
 39 | 
 40 |   if(ds2 == NULL) {
 41 |     printf("不能打开第二个文件，请检查文件是否存在！");
 42 |     return ;
 43 |   }
 44 | 
 45 |   //第二个文件中的数据
 46 |   float **InBuf2 = new float*[BandNum];
 47 | 
 48 |   for(i = 0; i < BandNum; i++) {
 49 |     InBuf2[i] = new float[WidthAll * HightAll];
 50 |     GDALRasterBand *band = ds2->GetRasterBand(i + 1);
 51 |     band->RasterIO(GF_Read,
 52 |                    0,
 53 |                    0,
 54 |                    WidthAll,
 55 |                    HightAll,
 56 |                    InBuf2[i],
 57 |                    WidthAll,
 58 |                    HightAll,
 59 |                    GDT_Float32,
 60 |                    0,
 61 |                    0);
 62 |   }
 63 | 
 64 |   //写入的数据(可以最后创建写入文件,需要先创建写入数据)
 65 |   float **outBuf = new float*[BandNum];
 66 | 
 67 |   for(i = 0; i < BandNum; i++) {
 68 |     outBuf[i] = new float[WidthAll * HightAll];
 69 |   }
 70 | 
 71 |   ////////////////////////////////////////////////////
 72 |   /////////////////////处理///////////////////////////
 73 |   ////////////////////////////////////////////////////
 74 |   //简单相加示例，实际上，这部分最好写入函数，或者类中单独封装起来，方便使用
 75 |   for(j = 0; j < BandNum; j++) {
 76 |     for(k = 0; k < WidthAll * HightAll; k++) {
 77 |       outBuf[j][k] = InBuf1[j][k] + InBuf2[j][k];
 78 |     }
 79 |   }
 80 | 
 81 |   ////////////////////////////////////////////////////
 82 |   /////////////////////处理///////////////////////////
 83 |   ////////////////////////////////////////////////////
 84 |   //创建写入图像：
 85 |   GDALDriver *poDriver;
 86 |   const char *pszFormat = "GTiff";
 87 |   poDriver = GetGDALDriverManager()->GetDriverByName(pszFormat);
 88 | 
 89 |   if(poDriver == NULL) {
 90 |     return;
 91 |   }
 92 | 
 93 |   GDALDataset *OutDs;
 94 |   char **papszOptions = NULL;
 95 |   char **papszMetadata;
 96 |   //这里的参数全是指tif格式的参数，如果是其他格式，请把这里所有注释掉，或者参照文档，自行设定
 97 |   //设置压缩类型，envi只认得packbits压缩.
 98 |   //papszOptions = CSLSetNameValue( papszOptions, "COMPRESS", "PACKBITS" );
 99 |   //设置压缩比,可以不用,有些时候压缩反而更大,因为是无损的,除非图片很大
100 |   //papszOptions = CSLSetNameValue( papszOptions, "ZLEVEL", "9" );
101 |   //设置bsq或者BIP存储 bsq:BAND,bip:PIXEL
102 |   papszOptions = CSLSetNameValue(papszOptions, "INTERLEAVE", "BAND");
103 |   OutDs = poDriver->Create("output.tif",
104 |                            WidthAll,
105 |                            HightAll,
106 |                            BandNum,
107 |                            GDT_Float32,
108 |                            papszOptions);
109 |   double geos[6];
110 |   //获取第一幅图的地理变化信息，这里如果与原图不同，请自己计算
111 |   ds1->GetGeoTransform(geos);
112 |   char *pszProjection = NULL;
113 |   char *pszPrettyWkt = NULL;
114 |   //设置为第一幅图的投影，如果与原图不同，请跳过这个if部分，到下个部分直接设置投影
115 |   //设置投影，如果需要特殊投影，请找到wkt串，自行建立投影后传入
116 |   OGRSpatialReferenceH  hSRS;
117 | 
118 |   if(GDALGetProjectionRef(ds1) != NULL) {
119 |     pszProjection = (char *) GDALGetProjectionRef(ds1);
120 |     hSRS = OSRNewSpatialReference(NULL);
121 | 
122 |     if(OSRImportFromWkt(hSRS, &pszProjection) == CE_None) {
123 |       OSRExportToPrettyWkt(hSRS, &pszPrettyWkt, FALSE);
124 |       OutDs->SetProjection(pszPrettyWkt);
125 |     }
126 |   }
127 | 
128 |   //pszPrettyWkt实际上是ogc wkt串或者是proj4
129 |   //如果指定投影的，可以在http://spatialreference.org/ 网站中搜索
130 |   //找到所需要的投影后，例如西安80  3度带，中央经线117E，就是EPSG:2384，点开后
131 |   //点击ogc wkt或者proj4，抄下来就行,proj4比较短，而且没有双引号不需要转义，比较简单
132 |   //pszPrettyWkt = "+proj=tmerc +lat_0=0 +lon_0=117 +k=1 +x_0=500000
133 |   //                +y_0=0 +a=6378140 +b=6356755.288157528 +units=m +no_defs";
134 |   //OutDs->SetProjection(pszPrettyWkt);
135 |   //设置坐标
136 |   OutDs->SetGeoTransform(geos);
137 |   CPLFree(pszPrettyWkt);
138 | 
139 |   //写入数据到outds中
140 |   for(i = 0; i < BandNum; i++) {
141 |     GDALRasterBand *outBand = OutDs->GetRasterBand(i + 1);
142 |     outBand->RasterIO(GF_Write,
143 |                       0,
144 |                       0,
145 |                       WidthAll,
146 |                       HightAll,
147 |                       outBuf[i],
148 |                       WidthAll,
149 |                       HightAll,
150 |                       GDT_Float32,
151 |                       0,
152 |                       0);
153 |   }
154 | 
155 |   //关闭dataset之后，数据才会真正写入到文件中，否则都是在缓存中！！！
156 |   GDALClose(OutDs);
157 |   GDALClose(ds1);
158 |   GDALClose(ds2);
159 | 
160 |   //清理环境，删除new的数组、变量等
161 |   for(i = 0; i < BandNum; i++) {
162 |     delete[] InBuf1[i];
163 |     delete[] InBuf2[i];
164 |     delete[] outBuf[i];
165 |   }
166 | 
167 |   delete[] InBuf1;
168 |   delete[] InBuf2;
169 |   delete[] outBuf;
170 |   getchar();
171 |   return 0;
172 | }
173 | 


--------------------------------------------------------------------------------
/ogr-architecture.rst:
--------------------------------------------------------------------------------
  1 | .. highlight:: rst
  2 | 
  3 | .. _ograrchitecture:
  4 | 
  5 | ############################
  6 | OGR矢量结构
  7 | ############################
  8 | 本章主要介绍OGR中矢量类型的架构,与 :ref:`gdaldatamodel` 一节类似,主要讲解OGR中矢量的整体结构，和其中涉及到的类，OGR设计是参照OpenGIS中的简单要素模型，因此本章中会简单介绍一些OpenGIS中的内容。本章节主要是对应 ``GDAL1.11`` 以下版本， ``GDAL2.0`` 以上版本中，将 :ref:`ogrdirver` 修改为 ``GDALDriver`` ，将 :ref:`datasource` 修改为 ``GDALDataset`` ，其他没有明显变化和修改。本章主要参考 `OGR Architecture <http://gdal.org/1.11/ogr/ogr_arch.html>`_ ， `OpenGIS的一些基本概念 <http://lab.osgeo.cn/7124.html>`_ 。
  9 | 
 10 | .. _vector:
 11 | 
 12 | ************************************
 13 | OpenGIS中矢量要素简介
 14 | ************************************
 15 | OpenGIS定义了一组基于数据的服务，而数据的基础是要素 ``Feature`` 。所谓要素，简单地说就是一个独立的对象，在地图中可能表现为一个多边形建筑物，在数据库中即一个独立的条目。要素具有两个必要的组成部分，几何信息和属性信息。
 16 | 
 17 | OpenGIS将几何信息分为点、边缘、面和几何集合四种：其中我们熟悉的线 ``Linestring`` 属于边缘的一个子类，而多边形 ``Polygon`` 是面的一个子类。也就是说OpenGIS定义的几何类型并不仅仅是我们常见的点、线、多边形三种，它提供了更复杂更详细的定义，增强了未来的可扩展性。另外，几何类型的设计中采用了组合模式 ``Composite`` ，将几何集合 ``GeometryCollection`` 也定义为一种几何类型，类似地，要素集合 ``FeatureCollection`` 也是一种要素。属性信息没有做太大的限制，可以在实际应用中结合具体的实现进行设置。
 18 | 
 19 | 相同的几何类型、属性类型的组合成为要素类型 ``FeatureType`` ，要素类型相同的要素可以被存放在一个数据源中。而一个数据源只能拥有一个要素类型。因此，可以用要素类型来描述一组属性相似的要素。在面向对象的模型中，完全可以把要素类型理解为一个类，而要素则是类的实例。
 20 | 
 21 | 实际理解中，可以将数据源理解为一个数据库，有多个图层，每个图层相当于一张数据表，每个数据表中有一个字段存储几何数据( OGR 1.11以后可以有多个几何数据字段)，其他字段中存储该数据的属性，如下图所示：
 22 | 
 23 | .. figure:: img/vector.png
 24 |    :alt: vector structS
 25 |    :align: center
 26 | 
 27 | .. _ogroverview:
 28 | 
 29 | ******************
 30 | OGR类总览
 31 | ******************
 32 | 总体结构如下所示：
 33 | 
 34 | * ``Geometry`` 几何形状： ``OGRGeometry`` 类以及其子类封装了OpenGIS模型中矢量数据，提供了一些几何操作，以及转换为WKB、WKT的操作，每个几何形状中包含有空间参考系统（投影）。
 35 | * ``Spatial Reference`` 空间参考：``OGRSpatialReference`` 类封装了投影和水准面。
 36 | * ``Feature`` 要素： ``OGRFeature`` 类封装一个要素，包括其几何形状和其他属性信息
 37 | * ``Feature Class Definition`` 要素类定义: ``OGRFeatureDefn`` 类通常存储整个图层的属性的元数据
 38 | * ``Layer`` 图层： ``OGRLayer`` 表示一个图层，同类型要素的集合
 39 | * ``Data Source`` 数据源： ``OGRDataSource`` 表示存储矢量数据的文件或数据库对象
 40 | * ``Drivers`` 驱动： ``OGRSFDriver`` 每个驱动可以可以打开对应类型的数据，转换为数据源，通过  ``OGRSFDriverRegistrar`` 管理。
 41 | 
 42 | .. _geometry:
 43 | 
 44 | ******************
 45 | 几何形状
 46 | ******************
 47 | 几何形状类用于表示各种几何矢量。它的派生类包括了各种形状，有如下类型： ``OGRPoint`` , ``OGRLineString`` , ``OGRPolygon`` , ``OGRGeometryCollection`` , ``OGRMultiPolygon`` , ``OGRMultiPoint`` ,  ``OGRMultiLineString`` ，其派生关系如下：
 48 | 
 49 | .. figure:: img/classOGRGeometry.png
 50 |    :alt: vector structS
 51 |    :align: center
 52 | 
 53 |    **OGRGeometry 类**
 54 | 
 55 | :ref:`ograrchitecture` 中提到，OGR设计参照的是OpenGIS中的简单要素模型，下面就是OpenGIS规范中的设计：
 56 | 
 57 | .. figure:: img/opengis_geometry.*
 58 |    :alt: vector structS
 59 |    :align: center
 60 | 
 61 |    **OpenGIS Geometry 描述**
 62 | 
 63 | ``OGRCurve`` 、 ``OGRSurface`` 两个中间抽象基类抽象出一些公用的功能，当前在简单要素模型中的一些中间基类没有出现在OGR中，以后可能会改变。
 64 | 
 65 | ``OGRGeometryFactory`` 类用于将 ``WKT`` 或 ``WKB`` 串转化为几何形状。
 66 | 
 67 | ``OGRGeometry`` 包含 ``OGRSpatialReference`` 的引用，用于定义几何形状的空间参考。
 68 | 
 69 | 很多分析功能暂时没有在 ``OGRGeometry`` 中实现。
 70 | 
 71 | 虽然理论上可以从现有的 ``OGRGeometry`` 类中派生出更多的其他几何形状，但是目前没有成熟方案。而且，可以使用 ``OGRGeometryFactory`` 创建特殊几何形状而不用修改它。
 72 | 
 73 | .. _spatialreference:
 74 | 
 75 | ******************
 76 | 空间参考
 77 | ******************
 78 | ``OGRSpatialReference`` 类用于实现OpenGIS空间参考系统定义。目前已经支持本地坐标系、地理坐标系、投影坐标系、垂直坐标系、地心坐标系、复合坐标系。
 79 | 
 80 | 空间坐标系统是从OpenGIS定义的WKT投影格式中继承的。其中简单模式在``Simple Features specifications`` 中定义，复杂模式在 ``Coordinate Transformation specification`` 中定义， ``OGRSpatialReference`` 类实现是建立在 ``Coordinate Transformation specification`` 模式上，但是兼容早期的简单模式。
 81 | 
 82 | ``OGRCoordinateTransformation`` 类使用 ``PROJ.4`` 库实现坐标转换。请参照坐标转换相关内容。
 83 | 
 84 | .. _feature:
 85 | 
 86 | ******************
 87 | 要素/要素类定义
 88 | ******************
 89 | ``OGRFeature`` 保存几何形状和其属性、ID、要素类标识符。从 OGR1.11开始，要素中可以有多个几何形状字段。
 90 | 
 91 | ``OGRFeatureDefn`` 用于表示要素属性的类型、名称等元数据信息。一个 ``OGRFeatureDefn`` 通常用于表示一个图层的要素属性信息。具有相同要素类定义的要素通过引用计数的方式共享同一个要素类定义。
 92 | 
 93 | 要素ID（FID）在图层中是唯一的，用于标识。单独的要素或者还未写入图层的要素可能有空FID，在OGR中FID用长整型表示，而其他模型中并不一定，例如GML中用字符串表示，而Oracle中行ID比长整型要大。
 94 | 
 95 | 要素类中包含几何类型（使用 ``OGRFeatureDefn::GetGeomType()`` 获取 ``OGRwkbGeometryType`` ），如果是wkbUnknown类型，那么该要素中可以添加任意类型的几何形状。这意味着一个图层中可以有不同的几何形状。
 96 | 
 97 | 从 ``OGR 1.11`` 开始，要素允许有多个几何字段，每个几何字段可以有不同的类型值和不同的空间参考系统。
 98 | 
 99 | ``OGRFeatureDefn`` 包含要素类名称，通常作为图层名称。
100 | 
101 | .. _layer:
102 | 
103 | ******************
104 | 图层
105 | ******************
106 | ``OGRLayer`` 表示数据源中的一层要素，同一图层的要素有相同的属性， ``OGRLayer`` 中也包含从数据源中读写要素的方法。图层主要用于在数据源中读写数据，通常代表一个文件，或者是空间表。
107 | 
108 | ``OGRLayer`` 有顺序和随机读写方法， ``GetNextFeature`` 方法可以顺序读取所有要素，可以使用 ``SetSpatialFilter`` 等滤波器限定该方法获取的要素范围。 
109 | 
110 | 当前 ``OGR`` 有一个缺陷：一个图层只能设置一个空间滤波器，以后将引入 ``OGRLayerView`` 或其他方式来改进。
111 | 
112 | ``OGRLayer`` 和 ``OGRFeatureDefn`` 虽然是一一对应的关系，但是设计为两个类的原因如下：
113 | 
114 |     1. OGRFeatureDefn 和 OGRFeature 并不依赖于 OGRLayer ，因此两者可以独立存在于内存中。
115 |     2. SF CORBA模型与SFCOM 和 SFSQL 不同，并没有图层与固定属性列的概念，在OGR中实现SFCORBA需要考虑这些。
116 | 
117 | ``OGRLayer`` 是一个抽象类，每个驱动将单独实现， ``OGRLayers`` 通常都由 ``OGRDataSource`` 直接创建，而不能直接初始化或者删除。
118 | 
119 | .. _datasource:
120 | 
121 | ******************
122 | 数据源
123 | ******************
124 | ``OGRDataSource`` 表示 ``OGRLayer`` 对象集合。通常代表单个文件、一系列文件、数据库或者网关。 ``OGRDataSource`` 通常拥有 ``OGRLayer`` 列表，可以返回它们的引用。
125 | 
126 | ``OGRDataSource`` 是抽象基类，将有每个格式的驱动实现， ``OGRDataSource`` 对象通常由对应的 OGRSFDriver 实例化，删除 ``OGRDataSource`` 对象仅是关闭其对数据源的访问，而非物理删除数据源。
127 | 
128 | ``OGRSFDriver`` 可以通过 ``OGRDataSource`` 的名称(通常为文件名)重新打开数据源。
129 | 
130 | ``OGRDataSource`` 可以通过 ``ExecuteSQL`` 方法执行对数据源的特殊命令，例如用SQL进行查询，虽然一些数据源底层支持空间SQL操作，OGR也实现了对任意数据源的查询操作（SQL的子集）。
131 | 
132 | .. _ogrdirver:
133 | 
134 | ******************
135 | 驱动
136 | ******************
137 | ``OGRSFDriver`` 用于将对应格式的文件对象实例化， ``OGRSFDriverRegistrar`` 用于注册各种驱动。每个格式有对应的派生类来实例化 ``OGRDataSource`` 和 ``OGRLayer`` 。
138 | 
139 | 在应用程序启动时需要调用所需文件格式的驱动，这些函数实例化对应的驱动对象，通过 ``OGRSFDriverRegistrar`` 注册。当数据源打开时，``OGRSFDriverRegistrar`` 将遍历使用所有的驱动，直到成功返回 ``OGRDataSource`` 对象。
140 | 


--------------------------------------------------------------------------------
/ogr-sql.rst:
--------------------------------------------------------------------------------
  1 | .. highlight:: rst
  2 | .. _OGRsql:.. _OGRsql:
  3 | 
  4 | .. _OGRsql:
  5 | 
  6 | ############################
  7 | OGR SQL
  8 | ############################
  9 | 本章来源：
 10 | 
 11 | * GDAL官网: `OGR SQL <http://www.gdal.org/ogr_sql.html>`_  
 12 | * GDAL WIKI: `RFC 28: OGR SQL Generalized Expressions <https://trac.osgeo.org/gdal/wiki/rfc28_sqlfunc>`_
 13 | 
 14 | ********************
 15 | 简介
 16 | ********************
 17 | ``GDALDataset`` 支持使用 ``GDALDataset::ExecuteSQL()`` 进行SQL操作,理论上该方法可以支持任何命令,但实际上主要是SQL SELECT 的子集.本篇主要讨论基本SQL和OGR实现的SQL,以及特定驱动的SQL支持.
 18 | 
 19 | 自GDAL/OGR 1.10 起,可以使用SQLITE语法代替OGRSQL语法,SQLITE语法将在下文中详细介绍
 20 | 
 21 | ``OGRLayer::SetAttributeFilter()`` 方法中也支持OGRSQL过滤,用法与SELECT语句中WHERE从句用法一致
 22 | 
 23 | .. attention::
 24 | 
 25 |     OGR SQL在 版本1.8.0后有效,最好升级到新的版本中
 26 | 
 27 | ********************
 28 | SELECT
 29 | ********************
 30 | 
 31 | 语法如下::
 32 | 
 33 |     SELECT <field-list> FROM <table_def>
 34 |          [LEFT JOIN <table_def> 
 35 |           ON [<table_ref>.]<key_field> = [<table_ref>.].<key_field>]*
 36 |          [WHERE <where-expr>] 
 37 |          [ORDER BY <sort specification list>]
 38 | 
 39 |     <field-list> ::= <column-spec> [ { , <column-spec> }... ]
 40 | 
 41 |     <column-spec> ::= <field-spec> [ <as clause> ]
 42 |                      | CAST ( <field-spec> AS <data type> ) [ <as clause> ]
 43 | 
 44 |     <field-spec> ::= [DISTINCT] <field_ref>
 45 |                      | <cumm-field-func> ( [DISTINCT] <field-ref> )
 46 |                      | <field-expr>
 47 |                      | Count(*)
 48 | 
 49 |     <field-expr> ::= <field_ref>
 50 |                      | <constant-value>
 51 |                      | <field-expr> <field-operator> <field-expr>
 52 |                      | <field-func> ( <field-expr-list> )
 53 |                      | ( <field-expr> )
 54 | 
 55 |     <field-expr-list> ::= field-expr
 56 |                      |  field-expr , field-expr-list
 57 |                      |  <empty>
 58 | 
 59 |     <as clause> ::= [ AS ] <column_name>
 60 | 
 61 |     <data type> ::= character [ ( field_length ) ]
 62 |                     | float [ ( field_length ) ]
 63 |                     | numeric [ ( field_length [, field_precision ] ) ]
 64 |                     | integer [ ( field_length ) ]
 65 |                     | date [ ( field_length ) ]
 66 |                     | time [ ( field_length ) ]
 67 |                     | timestamp [ ( field_length ) ]
 68 | 
 69 |     <cumm-field-func> ::= AVG | MAX | MIN | SUM | COUNT
 70 | 
 71 |     <field-operator> ::= '+' | '-' | '/' | '*' | '||'
 72 | 
 73 |     <field-func> ::= CONCAT | SUBSTR
 74 | 
 75 |     <field_ref>  ::= [<table_ref>.]field_name
 76 | 
 77 | ********************
 78 | SPECIAL FIELDS
 79 | ********************
 80 | OGR SQL中有一些特殊属性可以使用.比如几何属性等.
 81 | 
 82 | ==============
 83 | FID
 84 | ==============
 85 | 一般FID不作为要素的属性,只用于标识,但某些情况下能方便的查询,*不包括FID,所以必须单独写出来
 86 | 
 87 | .. code-block:: sql
 88 | 
 89 |     SELECT FID, * FROM nation;
 90 | 
 91 | ==============
 92 | OGR_GEOMETRY
 93 | ==============
 94 | MapInfo等数据类型中可以在同一层使用多种几何类型,所以可以使用此字段进行选择:
 95 | 
 96 | 
 97 | .. code-block:: sql
 98 | 
 99 |     SELECT * FROM nation WHERE OGR_GEOMETRY='POINT' OR OGR_GEOMETRY='POLYGON'
100 | 
101 | ==============
102 | OGR_GEOM_WKT
103 | ==============
104 | OGR_GEOM_WKT 可以显示要素的WKT串作为输出,也可以在WHERE从句中指定WKT类型等进行过滤::
105 | 
106 |     SELECT OGR_GEOM_WKT, * FROM nation;
107 |     SELECT OGR_GEOM_WKT, * FROM nation WHERE OGR_GEOM_WKT \
108 |             LIKE 'POINT%' OR OGR_GEOM_WKT LIKE 'POLYGON%';
109 | 
110 | ==============
111 | OGR_GEOM_AREA
112 | ==============
113 | 该字段使用OGRSurface::get_Area() 方法获取几何要素的面积,如果不是面状要素,则返回0
114 | 
115 | .. code-block:: sql
116 | 
117 |     SELECT * FROM nation WHERE OGR_GEOM_AREA > 10000000
118 | 
119 | ==============
120 | OGR_STYLE
121 | ==============
122 | 该字段代表使用OGRFeature::GetStyleString()获取的字符串,一般用于where从句过滤
123 | 
124 | 
125 | .. code-block:: sql
126 | 
127 |     SELECT * FROM nation WHERE OGR_STYLE LIKE 'LABEL%'
128 | 
129 | ********************
130 | ALTER TABLE
131 | ********************
132 | 用于增删改字段,主要用法如下:
133 | 
134 | .. code-block:: sql
135 | 
136 |     /*添加字段*/
137 |     ALTER TABLE tablename ADD [COLUMN] columnname columntype
138 |     /*重命名字段*/
139 |     ALTER TABLE tablename RENAME [COLUMN] oldcolumnname TO newcolumnname
140 |     /*修改字段类型*/
141 |     ALTER TABLE tablename ALTER [COLUMN] columnname TYPE columntype
142 |     /*删除字段*/
143 |     ALTER TABLE tablename DROP [COLUMN] columnname
144 | 
145 | 支持的数据类型如下::
146 | 
147 |     boolean     /*GDAL>2.0*/
148 |     character   /*需要指定field_length,默认为1*/
149 |     float       /*field_length*/
150 |     numeric     /*field_length, field_precision*/
151 |     smallint    /*field_length 16bit signed integer GDAL>2.0*/
152 |     integer     /*field_length*/
153 |     bigint      /*field_length 64bit integer GDAL>2.0*/
154 |     date        /*field_length*/
155 |     time        /*field_length*/
156 |     timestamp   /*field_length*/
157 |     geometry,geometry/*geometry_type*/,geometry/*geometry_type,type_code*/
158 | 
159 | 例如,可以使用ogrinfo 命令,修改文件字段
160 | 
161 | .. code-block:: bash
162 | 
163 |     ogrinfo -sql "alter table out add COLUMN myfield integer" out.shp
164 | 
165 | ********************
166 | ExecuteSQL()
167 | ********************
168 | 只有GDALDataset才能执行ExecuteSQL函数,该函数不针对Layer处理
169 | 
170 | .. code-block:: sql
171 | 
172 |     /**
173 |     * @param pszSQLCommand     SQL命令
174 |     * @param poSpatialFilter   空间范围设定
175 |     * @param pszDialect        针对不同驱动,有不同语法,一般置为NULL
176 |     */
177 |     OGRLayer * GDALDataset::ExecuteSQL( const char *pszSQLCommand,
178 |                                           OGRGeometry *poSpatialFilter,
179 |                                           const char *pszDialect );
180 | 
181 | 
182 | ********************
183 | Non-OGR SQL
184 | ********************
185 | 
186 | MySQL, PostgreSQL  PostGIS (PG), Oracle (OCI), SQLite, ODBC, ESRI Personal Geodatabase (PGeo)  MS SQL Spatial (MSSQLSpatial) 这些数据库系统都自己重写了
187 | GDALDataset::ExecuteSQL()  方法,有些语法上有细微的差别,另外其他语句也可以在这些驱动中运行.但是只有 SQL WHERE 语句才能返回 Layer.
188 | 
189 | 


--------------------------------------------------------------------------------
/code/sub2tif.c:
--------------------------------------------------------------------------------
  1 | /**
  2 |   GDALAllRegister,仅此一次
  3 | */
  4 | void RegisterAll()
  5 | {
  6 |   if(GDALGetDriverByName("GTiff") == NULL) {
  7 |     GDALAllRegister();
  8 |   }
  9 | }
 10 | 
 11 | /**
 12 | 所有subset转成一个tif
 13 |   @param fileName    输入文件名
 14 |   @param outfile     输出文件名
 15 |   @param pBandIndex  所需输出的数据集，用数组表示，从1开始，例如[1,3,5]，传入NULL表示全部数据集
 16 |   @param pBandCount  所需输出数据集个数，如果pBandIndex设置为NULL，此参数无作用
 17 |   @return
 18 |  */
 19 | void subsets2tif(const char *fileName, const char *outfile, \
 20 |                  int *pBandIndex, int pBandCount)
 21 | {
 22 |   int i, j;
 23 |   char *outFileName = NULL; //输出文件名
 24 | 
 25 |   if(outfile == NULL) {
 26 |     int charNum = strlen(fileName);
 27 |     charNum += 5;
 28 |     outFileName = new char[charNum];
 29 |     strcpy(outFileName, fileName);
 30 |     strcat(outFileName, ".tif") ;
 31 |   } else {
 32 |     int charNum = strlen(outfile);
 33 |     outFileName = new char[charNum + 1];
 34 |     strcpy(outFileName, outfile);
 35 |   }
 36 | 
 37 |   RegisterAll();//注册类型，打开影像必须加入此句
 38 |   GDALDataset *pDataSet = (GDALDataset *) GDALOpen(fileName, GA_ReadOnly);
 39 | 
 40 |   if(pDataSet == NULL) {
 41 |     printf("不能打开该文件，请检查文件是否存在！");
 42 |     return ;
 43 |   }
 44 | 
 45 |   //获取子数据集
 46 |   char **papszSUBDATASETS = pDataSet->GetMetadata("SUBDATASETS");
 47 |   int subdsNumber =  papszSUBDATASETS == NULL ? 1 : CSLCount(papszSUBDATASETS) / 2;
 48 |   char **vSubDataSets = new char*[subdsNumber]; //子数据集名称列表
 49 |   char **vSubDataDesc = new char*[subdsNumber]; //子数据集描述列表
 50 |   char *papszMetadata = NULL;
 51 | 
 52 |   //如果没有子数据集，则其本身就是一个数据集
 53 |   if(papszSUBDATASETS == NULL) {
 54 |     const char *Metadata = GDALGetDriverShortName((GDALDriverH)pDataSet);
 55 |     vSubDataSets[0] = new char[strlen(Metadata) + 1];
 56 |     vSubDataDesc[0] = new char[strlen(Metadata) + 1];
 57 |     strcpy(vSubDataSets[0], Metadata);
 58 |     strcpy(vSubDataDesc[0], Metadata);
 59 |   } else {
 60 |     int iCount = CSLCount(papszSUBDATASETS);  //计算子数据集的个数
 61 | 
 62 |     if(iCount <= 0) {   //没有子数据集,则返回
 63 |       GDALClose((GDALDriverH)pDataSet);
 64 |       return;
 65 |     }
 66 | 
 67 |     //将子数据集压入列表
 68 |     for(i = 0, j = 0; papszSUBDATASETS[i] != NULL; i++) {
 69 |       if(i % 2 != 0) {
 70 |         continue;
 71 |       }
 72 | 
 73 |       char *setInfo = papszSUBDATASETS[i];
 74 |       setInfo = strstr(setInfo, "=");
 75 | 
 76 |       if(setInfo[0] == '=') {
 77 |         memmove(setInfo, setInfo + 1, strlen(setInfo)); //提取元数据中子数据集名称
 78 |         vSubDataSets[j] = new char[strlen(setInfo) + 1];
 79 |         strcpy(vSubDataSets[j], setInfo);
 80 |       }
 81 | 
 82 |       char *descptn = papszSUBDATASETS[i + 1];
 83 |       descptn = strstr(descptn, "=");
 84 | 
 85 |       if(descptn[0] == '=') {
 86 |         memmove(descptn, descptn + 1, strlen(descptn)); //提取元数据中子数据集描述
 87 |         vSubDataDesc[j] = new char[strlen(descptn) + 1];
 88 |         strcpy(vSubDataDesc[j], descptn);
 89 |       }
 90 | 
 91 |       j++;
 92 |     }//end for
 93 |   }
 94 | 
 95 |   int Width, Height;
 96 |   GDALDriver *poDriver;
 97 |   const char *pszFormat = "GTiff";
 98 |   poDriver = GetGDALDriverManager()->GetDriverByName(pszFormat);
 99 | 
100 |   if(poDriver == NULL) {
101 |     return;
102 |   }
103 | 
104 |   //将每个子数据集转为对应的tif假设所有数据集大小相同
105 |   bool init = false;
106 |   int iBands = pBandIndex != NULL ? pBandCount : subdsNumber;
107 |   int realBandCount = 0;
108 | 
109 |   for(i = 0; i < subdsNumber; i++) {
110 |     if(pBandIndex != NULL) {
111 |       bool runNext = true;
112 | 
113 |       for(j = 0; j < pBandCount; j++) {
114 |         if(pBandIndex[j] == (i + 1)) {
115 |           realBandCount = j + 1;
116 |           runNext = false;
117 |           break;
118 |         }
119 |       }
120 | 
121 |       if(runNext) {
122 |         continue;
123 |       }
124 |     } else {
125 |       realBandCount = i + 1;
126 |     }
127 | 
128 |     char *dsName = vSubDataSets[i];
129 |     GDALDataset *subDs = (GDALDataset *) GDALOpen(dsName, GA_ReadOnly);
130 | 
131 |     if(subDs == NULL) {
132 |       continue;
133 |     }
134 | 
135 |     Width = subDs->GetRasterXSize();
136 |     Height = subDs->GetRasterYSize();
137 |     void *subData;
138 |     GDALRasterBand *poBand = subDs->GetRasterBand(1);
139 |     GDALDataType eBufType = poBand->GetRasterDataType();
140 | 
141 |     switch(eBufType) {
142 |       case GDT_Byte:
143 |         subData = new char[Width * Height];
144 |         break;
145 | 
146 |       case GDT_Int16:
147 |         subData = new short[Width * Height];
148 |         break;
149 | 
150 |       case GDT_Int32:
151 |         subData = new int[Width * Height];
152 |         break;
153 | 
154 |       case GDT_Float32:
155 |         subData = new float[Width * Height];
156 |         break;
157 | 
158 |       case GDT_Float64:
159 |         subData = new double[Width * Height];
160 |         break;
161 | 
162 |       default:
163 |         subData = new double[Width * Height];
164 |         break;
165 |     }
166 | 
167 |     poBand->RasterIO(GF_Read, 0, 0, Width, Height, subData,\
168 |                      Width, Height, eBufType, 0, 0);
169 |     //写入影像
170 |     GDALDataset *pDstDs = NULL;
171 | 
172 |     if(!init) { //创建影像
173 |       char **papszOptions = NULL;
174 |       //设置bsq或者 BIP bsq:BAND,bip:PIXEL
175 |       papszOptions = CSLSetNameValue(papszOptions, "INTERLEAVE", "BAND");
176 |       pDstDs = poDriver->Create(outFileName, Width, Height, \
177 |                                 iBands, eBufType, papszOptions);
178 |       double geos[6];
179 |       subDs->GetGeoTransform(geos);//变换参数
180 |       char *pszProjection = NULL;
181 |       char *pszPrettyWkt = NULL;
182 |       //获取ds1坐标
183 |       OGRSpatialReferenceH  hSRS;
184 | 
185 |       if(GDALGetProjectionRef(subDs) != NULL) {
186 |         pszProjection = (char *) GDALGetProjectionRef(subDs);
187 |         hSRS = OSRNewSpatialReference(NULL);
188 | 
189 |         if(OSRImportFromWkt(hSRS, &pszProjection) == CE_None) {
190 |           OSRExportToPrettyWkt(hSRS, &pszPrettyWkt, FALSE);
191 |           pDstDs->SetProjection(pszPrettyWkt);
192 |         }
193 |       }
194 | 
195 |       //设置坐标
196 |       pDstDs->SetGeoTransform(geos);
197 |       CPLFree(pszPrettyWkt);
198 |       pDstDs->SetMetadata(subDs->GetMetadata());
199 |       pDstDs->FlushCache();
200 |       init = true;
201 |     } else {
202 |       //打开影像
203 |       pDstDs = (GDALDataset *) GDALOpen(outFileName, GA_Update);
204 |     }
205 | 
206 |     GDALRasterBand *poBandOut;
207 |     poBandOut = pDstDs->GetRasterBand(realBandCount);
208 |     poBandOut->SetScale(poBand->GetScale());
209 |     poBandOut->SetOffset(poBand->GetOffset());
210 |     poBandOut->SetUnitType(poBand->GetUnitType());
211 |     poBandOut->SetColorInterpretation(poBand->GetColorInterpretation());
212 |     poBandOut->SetDescription(poBand->GetDescription());
213 |     poBandOut->SetNoDataValue(poBand->GetNoDataValue());
214 |     //GDT_Float32和 **OutputImg 类型要对应！
215 |     poBandOut->RasterIO(GF_Write, 0, 0, Width, Height, \
216 |                         subData, Width, Height, eBufType, 0, 0);
217 |     pDstDs->FlushCache();
218 |     //关闭
219 |     GDALClose(subDs);
220 |     GDALClose(pDstDs);
221 |     delete[] subData;
222 |   }
223 | 
224 |   GDALClose(pDataSet);
225 | 
226 |   if(papszMetadata) {
227 |     delete papszMetadata;
228 |   }
229 | 
230 |   for(i = 0; i < subdsNumber; i++) {
231 |     delete[] vSubDataDesc[i];
232 |     delete[] vSubDataSets[i];
233 |   }
234 | 
235 |   delete[] vSubDataDesc;
236 |   vSubDataDesc = NULL;
237 |   delete[] vSubDataSets;
238 |   vSubDataSets = NULL;
239 |   delete[] outFileName;
240 | }


--------------------------------------------------------------------------------
/Makefile:
--------------------------------------------------------------------------------
  1 | # Makefile for Sphinx documentation
  2 | #
  3 | 
  4 | # You can set these variables from the command line.
  5 | SPHINXOPTS    =
  6 | SPHINXBUILD   = sphinx-build
  7 | PAPER         =
  8 | BUILDDIR      = _build
  9 | 
 10 | # User-friendly check for sphinx-build
 11 | ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1)
 12 | $(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/)
 13 | endif
 14 | 
 15 | # Internal variables.
 16 | PAPEROPT_a4     = -D latex_paper_size=a4
 17 | PAPEROPT_letter = -D latex_paper_size=letter
 18 | ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
 19 | # the i18n builder cannot share the environment and doctrees with the others
 20 | I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
 21 | 
 22 | .PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
 23 | 
 24 | help:
 25 | 	@echo "Please use \`make <target>' where <target> is one of"
 26 | 	@echo "  html       to make standalone HTML files"
 27 | 	@echo "  dirhtml    to make HTML files named index.html in directories"
 28 | 	@echo "  singlehtml to make a single large HTML file"
 29 | 	@echo "  pickle     to make pickle files"
 30 | 	@echo "  json       to make JSON files"
 31 | 	@echo "  htmlhelp   to make HTML files and a HTML help project"
 32 | 	@echo "  qthelp     to make HTML files and a qthelp project"
 33 | 	@echo "  devhelp    to make HTML files and a Devhelp project"
 34 | 	@echo "  epub       to make an epub"
 35 | 	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
 36 | 	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
 37 | 	@echo "  latexpdfja to make LaTeX files and run them through platex/dvipdfmx"
 38 | 	@echo "  text       to make text files"
 39 | 	@echo "  man        to make manual pages"
 40 | 	@echo "  texinfo    to make Texinfo files"
 41 | 	@echo "  info       to make Texinfo files and run them through makeinfo"
 42 | 	@echo "  gettext    to make PO message catalogs"
 43 | 	@echo "  changes    to make an overview of all changed/added/deprecated items"
 44 | 	@echo "  xml        to make Docutils-native XML files"
 45 | 	@echo "  pseudoxml  to make pseudoxml-XML files for display purposes"
 46 | 	@echo "  linkcheck  to check all external links for integrity"
 47 | 	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
 48 | 
 49 | clean:
 50 | 	rm -rf $(BUILDDIR)/*
 51 | 
 52 | html:
 53 | 	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
 54 | 	@echo
 55 | 	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
 56 | 
 57 | dirhtml:
 58 | 	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
 59 | 	@echo
 60 | 	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
 61 | 
 62 | singlehtml:
 63 | 	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
 64 | 	@echo
 65 | 	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
 66 | 
 67 | pickle:
 68 | 	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
 69 | 	@echo
 70 | 	@echo "Build finished; now you can process the pickle files."
 71 | 
 72 | json:
 73 | 	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
 74 | 	@echo
 75 | 	@echo "Build finished; now you can process the JSON files."
 76 | 
 77 | htmlhelp:
 78 | 	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
 79 | 	@echo
 80 | 	@echo "Build finished; now you can run HTML Help Workshop with the" \
 81 | 	      ".hhp project file in $(BUILDDIR)/htmlhelp."
 82 | 
 83 | qthelp:
 84 | 	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
 85 | 	@echo
 86 | 	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
 87 | 	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
 88 | 	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/headfirstgdal.qhcp"
 89 | 	@echo "To view the help file:"
 90 | 	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/headfirstgdal.qhc"
 91 | 
 92 | devhelp:
 93 | 	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
 94 | 	@echo
 95 | 	@echo "Build finished."
 96 | 	@echo "To view the help file:"
 97 | 	@echo "# mkdir -p $$HOME/.local/share/devhelp/headfirstgdal"
 98 | 	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/headfirstgdal"
 99 | 	@echo "# devhelp"
100 | 
101 | epub:
102 | 	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
103 | 	@echo
104 | 	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
105 | 
106 | latex:
107 | 	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
108 | 	@echo
109 | 	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
110 | 	@echo "Run \`make' in that directory to run these through (pdf)latex" \
111 | 	      "(use \`make latexpdf' here to do that automatically)."
112 | 
113 | latexpdf:
114 | 	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
115 | 	@echo "Running LaTeX files through pdflatex..."
116 | 	$(MAKE) -C $(BUILDDIR)/latex all-pdf
117 | 	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
118 | 
119 | latexpdfja:
120 | 	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
121 | 	@echo "Running LaTeX files through platex and dvipdfmx..."
122 | 	$(MAKE) -C $(BUILDDIR)/latex all-pdf-ja
123 | 	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
124 | 
125 | text:
126 | 	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
127 | 	@echo
128 | 	@echo "Build finished. The text files are in $(BUILDDIR)/text."
129 | 
130 | man:
131 | 	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
132 | 	@echo
133 | 	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
134 | 
135 | texinfo:
136 | 	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
137 | 	@echo
138 | 	@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
139 | 	@echo "Run \`make' in that directory to run these through makeinfo" \
140 | 	      "(use \`make info' here to do that automatically)."
141 | 
142 | info:
143 | 	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
144 | 	@echo "Running Texinfo files through makeinfo..."
145 | 	make -C $(BUILDDIR)/texinfo info
146 | 	@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
147 | 
148 | gettext:
149 | 	$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
150 | 	@echo
151 | 	@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
152 | 
153 | changes:
154 | 	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
155 | 	@echo
156 | 	@echo "The overview file is in $(BUILDDIR)/changes."
157 | 
158 | linkcheck:
159 | 	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
160 | 	@echo
161 | 	@echo "Link check complete; look for any errors in the above output " \
162 | 	      "or in $(BUILDDIR)/linkcheck/output.txt."
163 | 
164 | doctest:
165 | 	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
166 | 	@echo "Testing of doctests in the sources finished, look at the " \
167 | 	      "results in $(BUILDDIR)/doctest/output.txt."
168 | 
169 | xml:
170 | 	$(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml
171 | 	@echo
172 | 	@echo "Build finished. The XML files are in $(BUILDDIR)/xml."
173 | 
174 | pseudoxml:
175 | 	$(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml
176 | 	@echo
177 | 	@echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."
178 | 


--------------------------------------------------------------------------------
/make.bat:
--------------------------------------------------------------------------------
  1 | @ECHO OFF
  2 | SET SPHINXBUILD=F:\Users\win\AppData\Local\Programs\Python\Python35\Scripts\sphinx-build.exe
  3 | REM Command file for Sphinx documentation
  4 | 
  5 | if "%SPHINXBUILD%" == "" (
  6 | 	set SPHINXBUILD=sphinx-build
  7 | )
  8 | set BUILDDIR=_build
  9 | set ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% .
 10 | set I18NSPHINXOPTS=%SPHINXOPTS% .
 11 | if NOT "%PAPER%" == "" (
 12 | 	set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS%
 13 | 	set I18NSPHINXOPTS=-D latex_paper_size=%PAPER% %I18NSPHINXOPTS%
 14 | )
 15 | 
 16 | if "%1" == "" goto help
 17 | 
 18 | if "%1" == "help" (
 19 | 	:help
 20 | 	echo.Please use `make ^<target^>` where ^<target^> is one of
 21 | 	echo.  html       to make standalone HTML files
 22 | 	echo.  dirhtml    to make HTML files named index.html in directories
 23 | 	echo.  singlehtml to make a single large HTML file
 24 | 	echo.  pickle     to make pickle files
 25 | 	echo.  json       to make JSON files
 26 | 	echo.  htmlhelp   to make HTML files and a HTML help project
 27 | 	echo.  qthelp     to make HTML files and a qthelp project
 28 | 	echo.  devhelp    to make HTML files and a Devhelp project
 29 | 	echo.  epub       to make an epub
 30 | 	echo.  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter
 31 | 	echo.  text       to make text files
 32 | 	echo.  man        to make manual pages
 33 | 	echo.  texinfo    to make Texinfo files
 34 | 	echo.  gettext    to make PO message catalogs
 35 | 	echo.  changes    to make an overview over all changed/added/deprecated items
 36 | 	echo.  xml        to make Docutils-native XML files
 37 | 	echo.  pseudoxml  to make pseudoxml-XML files for display purposes
 38 | 	echo.  linkcheck  to check all external links for integrity
 39 | 	echo.  doctest    to run all doctests embedded in the documentation if enabled
 40 | 	goto end
 41 | )
 42 | 
 43 | if "%1" == "clean" (
 44 | 	for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i
 45 | 	del /q /s %BUILDDIR%\*
 46 | 	goto end
 47 | )
 48 | 
 49 | 
 50 | %SPHINXBUILD% 2> nul
 51 | if errorlevel 9009 (
 52 | 	echo.
 53 | 	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
 54 | 	echo.installed, then set the SPHINXBUILD environment variable to point
 55 | 	echo.to the full path of the 'sphinx-build' executable. Alternatively you
 56 | 	echo.may add the Sphinx directory to PATH.
 57 | 	echo.
 58 | 	echo.If you don't have Sphinx installed, grab it from
 59 | 	echo.http://sphinx-doc.org/
 60 | 	exit /b 1
 61 | )
 62 | 
 63 | if "%1" == "html" (
 64 | 	%SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html
 65 | 	if errorlevel 1 exit /b 1
 66 | 	echo.
 67 | 	echo.Build finished. The HTML pages are in %BUILDDIR%/html.
 68 | 	goto end
 69 | )
 70 | 
 71 | if "%1" == "dirhtml" (
 72 | 	%SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml
 73 | 	if errorlevel 1 exit /b 1
 74 | 	echo.
 75 | 	echo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml.
 76 | 	goto end
 77 | )
 78 | 
 79 | if "%1" == "singlehtml" (
 80 | 	%SPHINXBUILD% -b singlehtml %ALLSPHINXOPTS% %BUILDDIR%/singlehtml
 81 | 	if errorlevel 1 exit /b 1
 82 | 	echo.
 83 | 	echo.Build finished. The HTML pages are in %BUILDDIR%/singlehtml.
 84 | 	goto end
 85 | )
 86 | 
 87 | if "%1" == "pickle" (
 88 | 	%SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle
 89 | 	if errorlevel 1 exit /b 1
 90 | 	echo.
 91 | 	echo.Build finished; now you can process the pickle files.
 92 | 	goto end
 93 | )
 94 | 
 95 | if "%1" == "json" (
 96 | 	%SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json
 97 | 	if errorlevel 1 exit /b 1
 98 | 	echo.
 99 | 	echo.Build finished; now you can process the JSON files.
100 | 	goto end
101 | )
102 | 
103 | if "%1" == "htmlhelp" (
104 | 	%SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp
105 | 	if errorlevel 1 exit /b 1
106 | 	echo.
107 | 	echo.Build finished; now you can run HTML Help Workshop with the ^
108 | .hhp project file in %BUILDDIR%/htmlhelp.
109 | 	goto end
110 | )
111 | 
112 | if "%1" == "qthelp" (
113 | 	%SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp
114 | 	if errorlevel 1 exit /b 1
115 | 	echo.
116 | 	echo.Build finished; now you can run "qcollectiongenerator" with the ^
117 | .qhcp project file in %BUILDDIR%/qthelp, like this:
118 | 	echo.^> qcollectiongenerator %BUILDDIR%\qthelp\headfirstgdal.qhcp
119 | 	echo.To view the help file:
120 | 	echo.^> assistant -collectionFile %BUILDDIR%\qthelp\headfirstgdal.ghc
121 | 	goto end
122 | )
123 | 
124 | if "%1" == "devhelp" (
125 | 	%SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp
126 | 	if errorlevel 1 exit /b 1
127 | 	echo.
128 | 	echo.Build finished.
129 | 	goto end
130 | )
131 | 
132 | if "%1" == "epub" (
133 | 	%SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub
134 | 	if errorlevel 1 exit /b 1
135 | 	echo.
136 | 	echo.Build finished. The epub file is in %BUILDDIR%/epub.
137 | 	goto end
138 | )
139 | 
140 | if "%1" == "latex" (
141 | 	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
142 | 	if errorlevel 1 exit /b 1
143 | 	echo.
144 | 	echo.Build finished; the LaTeX files are in %BUILDDIR%/latex.
145 | 	goto end
146 | )
147 | 
148 | if "%1" == "latexpdf" (
149 | 	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
150 | 	cd %BUILDDIR%/latex
151 | 	make all-pdf
152 | 	cd %BUILDDIR%/..
153 | 	echo.
154 | 	echo.Build finished; the PDF files are in %BUILDDIR%/latex.
155 | 	goto end
156 | )
157 | 
158 | if "%1" == "latexpdfja" (
159 | 	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
160 | 	cd %BUILDDIR%/latex
161 | 	make all-pdf-ja
162 | 	cd %BUILDDIR%/..
163 | 	echo.
164 | 	echo.Build finished; the PDF files are in %BUILDDIR%/latex.
165 | 	goto end
166 | )
167 | 
168 | if "%1" == "text" (
169 | 	%SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text
170 | 	if errorlevel 1 exit /b 1
171 | 	echo.
172 | 	echo.Build finished. The text files are in %BUILDDIR%/text.
173 | 	goto end
174 | )
175 | 
176 | if "%1" == "man" (
177 | 	%SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man
178 | 	if errorlevel 1 exit /b 1
179 | 	echo.
180 | 	echo.Build finished. The manual pages are in %BUILDDIR%/man.
181 | 	goto end
182 | )
183 | 
184 | if "%1" == "texinfo" (
185 | 	%SPHINXBUILD% -b texinfo %ALLSPHINXOPTS% %BUILDDIR%/texinfo
186 | 	if errorlevel 1 exit /b 1
187 | 	echo.
188 | 	echo.Build finished. The Texinfo files are in %BUILDDIR%/texinfo.
189 | 	goto end
190 | )
191 | 
192 | if "%1" == "gettext" (
193 | 	%SPHINXBUILD% -b gettext %I18NSPHINXOPTS% %BUILDDIR%/locale
194 | 	if errorlevel 1 exit /b 1
195 | 	echo.
196 | 	echo.Build finished. The message catalogs are in %BUILDDIR%/locale.
197 | 	goto end
198 | )
199 | 
200 | if "%1" == "changes" (
201 | 	%SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes
202 | 	if errorlevel 1 exit /b 1
203 | 	echo.
204 | 	echo.The overview file is in %BUILDDIR%/changes.
205 | 	goto end
206 | )
207 | 
208 | if "%1" == "linkcheck" (
209 | 	%SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck
210 | 	if errorlevel 1 exit /b 1
211 | 	echo.
212 | 	echo.Link check complete; look for any errors in the above output ^
213 | or in %BUILDDIR%/linkcheck/output.txt.
214 | 	goto end
215 | )
216 | 
217 | if "%1" == "doctest" (
218 | 	%SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest
219 | 	if errorlevel 1 exit /b 1
220 | 	echo.
221 | 	echo.Testing of doctests in the sources finished, look at the ^
222 | results in %BUILDDIR%/doctest/output.txt.
223 | 	goto end
224 | )
225 | 
226 | if "%1" == "xml" (
227 | 	%SPHINXBUILD% -b xml %ALLSPHINXOPTS% %BUILDDIR%/xml
228 | 	if errorlevel 1 exit /b 1
229 | 	echo.
230 | 	echo.Build finished. The XML files are in %BUILDDIR%/xml.
231 | 	goto end
232 | )
233 | 
234 | if "%1" == "pseudoxml" (
235 | 	%SPHINXBUILD% -b pseudoxml %ALLSPHINXOPTS% %BUILDDIR%/pseudoxml
236 | 	if errorlevel 1 exit /b 1
237 | 	echo.
238 | 	echo.Build finished. The pseudo-XML files are in %BUILDDIR%/pseudoxml.
239 | 	goto end
240 | )
241 | 
242 | :end
243 | 


--------------------------------------------------------------------------------
/gdal-data-model.rst:
--------------------------------------------------------------------------------
  1 | .. highlight:: rst
  2 | .. _gdaldatamodel:
  3 | 
  4 | ################
  5 | GDAL数据模型
  6 | ################
  7 | 本章主要介绍GDAL的数据模型，通过上一章，我们大致了解数据集和波段的意义，这章中，我们来看GDAL中这些概念的实现。本章基本参考 `GDAL_Datamodel <http://www.gdal.org/gdal_datamodel.html>`_ 为了方便理解，没有完全按照原文翻译，有部分删改。
  8 | 
  9 | .. _dataset:
 10 | 
 11 | ******************
 12 | 数据集   
 13 | ******************
 14 | 上章介绍了，简单的说，一个数据集可以看作为一幅影像。它包括了元数据、投影信息、波段等等，GDAL中用 ``GDALDataset`` 类来表示数据集。数据集除了内部的波段，还包括以下内容：
 15 | 
 16 | .. _coordinatesystem:
 17 | 
 18 | 投影系统
 19 | ======================
 20 | GDAL中，使用的是 `WKT <http://www.geoapi.org/3.0/javadoc/org/opengis/referencing/doc-files/WKT.html>`_ 串来表示投影，具体的表示内容可以参考链接，下面用例子简单的介绍一下，#后面表示注释::
 21 | 
 22 |     PROJCS["WGS 84 / UTM zone 52N",                   #投影名称
 23 |         GEOGCS["WGS 84",                              #地理坐标系统名
 24 |             DATUM["WGS_1984",                         #水平基准面
 25 |                 SPHEROID["WGS 84",6378137,298.257223  #椭球体名称、长半轴、反偏率
 26 |                     AUTHORITY["EPSG","7030"]],        #外部权威的空间参考系统的编码
 27 |                 AUTHORITY["EPSG","6326"]],
 28 |             PRIMEM["Greenwich",0],                    #中央经线Greenwich，0度标准子午线
 29 |             UNIT["degree",0.0174532925199433],        #指定测量使用的单位。在地理坐标系下使用角度。
 30 |             AUTHORITY["EPSG","4326"]],
 31 |         PROJECTION["Transverse_Mercator"],            #投影方法，这里是通用墨卡托投影
 32 |         PARAMETER["latitude_of_origin",0],            #PARAMETER表示投影参数,0表示纬度起点为0度
 33 |         PARAMETER["central_meridian",129],            #投影带的中央经线是东经129度
 34 |         PARAMETER["scale_factor",0.9996],             #中央经线的长度比是0.9996
 35 |         PARAMETER["false_easting",500000],            #坐标纵轴向西移动500km
 36 |         PARAMETER["false_northing",0],                #横轴没有平移
 37 |         UNIT["metre",1,                               #指定测量使用的单位，指定米为测量单位。
 38 |             AUTHORITY["EPSG","9001"]],                #外部权威的空间参考系统的编码
 39 |         AUTHORITY["EPSG","32652"]]
 40 | 
 41 | 这部分和地图投影关系很大，如果没有基础，请参考 `地图投影系列介绍 <http://blog.sina.com.cn/s/blog_7f6303470101fzcw.html>`_ 和 `地图投影简明笔记 <http://www.cnblogs.com/yiyezhai/p/3182955.html>`_ 。
 42 | 
 43 | 使用 `GDALDataset::GetProjectionRef() <http://www.gdal.org/classGDALDataset.html#aa42537e1062ce254d124b29ff3ebe857>`_ 函数可以获取数据集的投影信息，GDAL中使用仿射变换可以将地理坐标和图像坐标进行转换，在下一节中我们将具体展示；使用 `GDALDataset::GetGCPProjection() <http://www.gdal.org/classGDALDataset.html#a35ea63c2f9ea12afd190ca2446d02ddb>`_ 可以获取GCP点的投影。返回均为WKT字符串，如果返回""，则表示该数据集没有投影或者投影没有被识别。
 44 | 
 45 | .. _affinegeotransform:
 46 | 
 47 | 仿射地理变换
 48 | ======================
 49 | GDAL数据集有两种方式表示栅格数据中像元位置（图像中某个点在影像中的行列号）和投影坐标系（不是经纬度，是投影到二维平面的地图坐标，二者可以通过地图投影进行相互转换）间的关系：仿射变换和GCP点。大部分数据都是用仿射变换描述的，本节中描述仿射变换。
 50 | 
 51 | 仿射变换由六个参数实现， ``GDALDataset::GetGeoTransform()`` 可以获取仿射变换参数数组。将像元位置转换为投影坐标的公式如下：
 52 | 
 53 | .. code-block:: c++
 54 | 
 55 |     /*
 56 |     六个参数分别是：
 57 |         geos[0]  top left x 左上角x坐标
 58 |         geos[1]  w-e pixel resolution 东西方向像素分辨率
 59 |         geos[2]  rotation, 0 if image is "north up" 旋转角度，正北向上时为0
 60 |         geos[3]  top left y 左上角y坐标
 61 |         geos[4]  rotation, 0 if image is "north up" 旋转角度，正北向上时为0
 62 |         geos[5]  n-s pixel resolution 南北向像素分辨率
 63 |         x/y为图像的x/y坐标，geox/geoy为对应的投影坐标
 64 |     */
 65 |     geox = geos[0] + geos[1] * x + geos[2] * y;
 66 |     geoy = geos[3] + geos[4] * x + geos[5] * y
 67 | 
 68 | 注意，上面所说的点/线坐标系是从左上角(0,0)点到右下角，也就是坐标轴从左到右增长，从上到下增长的坐标系（即影象的行列从左下角开始计算）。 点/线位置中心是(0.5,0.5)
 69 | 
 70 | .. _GCPs:
 71 | 
 72 | GCP点
 73 | ======================
 74 | 数据集可以由一系列控制点来定义空间参考坐标系。所有的GCP点共用 ``GDALDataset::GetGCPProjection()`` 获取的地理参考坐标系。GCP结构体在GDAL中表示如下：
 75 | 
 76 | .. code-block:: c++
 77 | 
 78 |     typedef struct
 79 |     {
 80 |         char    *pszId;        //ID，可以用字母+数字表示，不能重复
 81 |         char    *pszInfo;      //描述信息,一般为空
 82 |         double     dfGCPPixel;    //列号
 83 |         double    dfGCPLine;     //行号
 84 |         double    dfGCPX;        //投影x坐标
 85 |         double    dfGCPY;        //投影y坐标
 86 |         double    dfGCPZ;        //投影z坐标
 87 |     } GDAL_GCP;
 88 | 
 89 | **GDAL数据模型没有实现由GCPs产生坐标系的变化的机制** ，而是把具体的操作留给用户实现,一般采用多项式插值实现。
 90 | 
 91 | 如果数据集有投影的话，会包含仿射变换或GCPS。两者都有的很少见， 如果两者都有，则无法用权威坐标系定义。
 92 | 
 93 | .. _metadata:
 94 | 
 95 | 元数据
 96 | ======================
 97 | 
 98 | GDAL中，元数据是以键值对呈现的辅助数据，可以使用 :ref:`gdalinfo` 获取影像元数据，结果如图所示：
 99 | 
100 | .. figure:: img/keyvalue.png
101 |    :alt: key-value Image
102 |    :align: center
103 | 
104 | 如上图中红色部分所示，在 ``MetaData`` 栏中，所有的数据都是以 **key=value** 的方式组织的。 ``key`` 中不能设置空格和一些特殊字符， ``value`` 为非空值的任意长度的内容。一个数据集的元数据一般不超过100kb，否则会导致性能严重下降。
105 | 
106 | 一些数据格式支持用户自定义的基本元数据，一些数据格式会定义特殊的键。
107 | 
108 | 相似的元数据可以组成一个域，如上面的红色部分和绿色部分，就属于不同的域。默认域没有名称，有些特殊用途的元数据有特殊的域。目前虽然不能列举出一个对象所需要 的所有域，但是程序可以测试任何我们已经知道确切含义的域。
109 | 
110 | 下面介绍些常见的域。
111 |    
112 | .. _subdatasetsdomain:
113 | 
114 | 子数据集域
115 | -------------------
116 | :ref:`multidatasets` 中一般都会有这个域，用于存储子数据集的信息,一般是一个类似下面的信息列表::
117 | 
118 |     Subdatasets:
119 |         SUBDATASET_1_NAME=NETCDF:"example.nc":auditTrail
120 |         SUBDATASET_1_DESC=[2x80] auditTrail (8-bit character)
121 |         SUBDATASET_2_NAME=NETCDF:"example.nc":data
122 |         SUBDATASET_2_DESC=[1x61x172] data (32-bit floating-point)
123 |         SUBDATASET_3_NAME=NETCDF:"example.nc":lat
124 |         SUBDATASET_3_DESC=[61x172] lat (32-bit floating-point)
125 |         SUBDATASET_4_NAME=NETCDF:"example.nc":lon
126 |         SUBDATASET_4_DESC=[61x172] lon (32-bit floating-point)
127 | 
128 | ``NAME=`` 后面的内容是子数据集名称，用来打开数据集下的子数据集。``DESC=`` 后面跟的是描述。ADRG, ECRGTOC, GEORASTER, GTiff, HDF4, HDF5, netCDF, NITF, NTv2, OGDI, PDF, PostGISRaster, Rasterlite, RPFTOC, RS2, WCS, and WMS这些数据类型都有子数据集。
129 | 
130 | .. _imagestructuredomain:
131 | 
132 | 图像结构域
133 | -------------------
134 | 与影像格式相关的元数据信息将存在这个域中，就是上图中绿色部分。这部分元数据在转换格式的时候，一般不会自动拷贝到新数据中。其中有一些典型的条目，例如 ``COMPRESSION`` 表示压缩程度等。
135 | 
136 | .. _rpcdomain:
137 | 
138 | RPC域
139 | -------------------
140 | RPC元数据域描述有理多项式系数几何模型，这也是描述像元和地理参考位置之间变换信息用的。更详细的信息参见 `RPCs in GeoTIFF <http://geotiff.maptools.org/rpc_prop.html>`_ 文档。
141 | 
142 | 
143 | .. _xmldomains:
144 | 
145 | xml: 域
146 | -------------------
147 | 任何以 ``xml:`` 为前缀名的域都不是一个普通的键值对方式的元数据。它是一个存有xml字符串的单XML文档。
148 | 
149 | .. _rasterband:
150 | 
151 | ******************
152 | 波段
153 | ******************
154 | 波段是真正存储数据的结构，GDAL中用 ``GDALRasterBand`` 类来表示单个波段。
155 | 
156 | 波段有以下的性质：
157 | 
158 | * 宽和高：如果是全分辨率的波段，那长和宽与数据集中的定义是一样的。
159 | * 数据类型：有Byte, UInt16, Int16, UInt32, Int32, Float32, Float64, and the complex types CInt16, CInt32, CFloat32, and CFloat64类型.
160 | * 块大小：缓冲块的大小，tiff中一般是以行作为缓冲块
161 | * 描述字串：可选
162 | * nodata数值：可选
163 | * 光栅名称：可选，这个特性可以用来指定一些比较重要的数据。 
164 | * 波段的解释信息，枚举型：
165 |     + GCI_Undefined: 默认值. 
166 |     + GCI_GrayIndex: 灰度值波段 
167 |     + GCI_PaletteIndex: 颜色表索引 
168 |     + GCI_RedBand: 红色波段 
169 |     + GCI_GreenBand: 绿色波段 
170 |     + GCI_BlueBand: 蓝色波段 
171 |     + GCI_AlphaBand: 透明通道
172 |     + GCI_HueBand: 色调
173 |     + GCI_SaturationBand: 饱和度
174 |     + GCI_LightnessBand: 光强 
175 |     + GCI_CyanBand: 青色波段 
176 |     + GCI_MagentaBand: 品红波段 
177 |     + GCI_YellowBand: 黄色波段 
178 |     + GCI_BlackBand: t黑色波段.
179 | 
180 |  
181 | .. _colortable:
182 | 
183 | ******************
184 | 颜色表
185 | ******************
186 | 颜色表在GDAL中，由多个 ``GDALColorEntry`` 组成， ``GDALColorEntry`` 结构体描述如下：
187 | 
188 | .. code-block:: c++
189 | 
190 |     typedef struct
191 |     {
192 |         /- gray, red, cyan or hue -/
193 |         short      c1;
194 |         /- green, magenta, or lightness -/    
195 |         short      c2;
196 |         /- blue, yellow, or saturation -/
197 |         short      c3;
198 |         /- alpha or blackband -/
199 |         short      c4;      
200 |     } GDALColorEntry;
201 | 
202 | 颜色表同时还对应一个调色板（ ``GDALPaletteInterp`` ）， ``GDALColorEntry`` 中的 ``c1/c2/c3/c4`` 的 值可以作为调色板索引得到真正的颜色值。
203 | 
204 | * GPI_Gray: c1作为灰度值。
205 | * GPI_RGB: c1/c2/c3依次为Red/Green/Blue，c4对应alpha通道。
206 | * GPI_CMYK: c1为cyan，c2为magenta，c3为yellow，c4为black。
207 | * GPI_HLS: c1为hue，c2为lightness，c3为saturation。
208 | 
209 | 用颜色表表示时，每个像素保存的只是像素颜色在颜色表的位置。每个颜色的索引从 0开始递增。这里并没有提供针对颜色表的缩放机制。
210 | 
211 | .. _overviews:
212 | 
213 | ******************
214 | 金字塔层
215 | ******************
216 | 一个波段可以有零个或多个金字塔层，这个结构在构建影像金字塔的时候将用到。每个层都相当于独立的 ``GDALRasterBand``  。每层的行列数和原始的波段有所不同，但是覆盖的地理区域是相同的。
217 | 
218 | 金字塔层是原始波段的降采样实现的，一般用于快速显示。
219 | 
220 | 波段有 ``HasArbitraryOverviews`` 属性来判定在某些分辨率上是否有金字塔层。该属性可以应用于fft编码或者是网络传输切片等状况中。
221 | 
222 | 


--------------------------------------------------------------------------------
/gdal-tool-code.rst:
--------------------------------------------------------------------------------
  1 | .. highlight:: rst
  2 | .. _GDALUtilitiesWithCode:
  3 | 
  4 | ############################
  5 | GDAL工具集代码实现(C/C++)
  6 | ############################
  7 | 
  8 | `GDAL2.0` 开始，可以使用代码实现GDAL工具集的功能，即可以使用代码调用gdal工具集，可以提升编码效率。需要注意,使用参数时,需要逐个添加,不能一行按照空格添加。
  9 | 
 10 | 下面主要介绍 ``gdalinfo`` ``gdalwarp`` ``gdal_translate``  ``ogr2ogr``  几个常用工具的代码实现,其他可用工具见  `GDAL官网gdal_utils.h: GDAL Utilities C API <http://www.gdal.org/gdal__utils_8h.html>`_  说明,包括  ``gdaldem``  ``gdal_rasterize``  ``nearblack``   ``gdal_grid``  ``gdalbuildvrt`` 几个工具，其余工具官方正在添加。
 11 | 
 12 | 
 13 | 使用前,需要添加以下头文件:
 14 | 
 15 | .. code-block:: c++
 16 | 
 17 |     #include "gdal_priv.h"
 18 |     #include "cpl_string.h"
 19 |     #include "gdal_utils.h"
 20 | 
 21 | 
 22 | ****************************************
 23 | gdalinfo
 24 | ****************************************
 25 | 
 26 | :ref:`gdalinfo`  工具功能可以使用 ``GDALInfo`` 函数实现，具体定义如下:
 27 | 
 28 | .. code-block:: c++
 29 | 
 30 |     /**
 31 |     * @param hDataset   需要获取信息的数据集
 32 |     * @param psOptions  gdalinfo命令参数
 33 |     * @return 返回数据集信息
 34 |     */
 35 |     char* GDALInfo	(	GDALDatasetH 	hDataset,
 36 |     const GDALInfoOptions * 	psOptions 
 37 |     )
 38 | 
 39 | 
 40 | 基本使用方式如下:
 41 | 
 42 | .. code-block:: c++
 43 | 
 44 |     GDALAllRegister();
 45 |     GDALDatasetH TestDs = GDALOpen( "testfile.tiff", GA_ReadOnly );
 46 |     char* info = GDALInfo(TestDs,NULL);
 47 |     std::cout<<info<<std::endl;
 48 |     //do something
 49 |     GDALClose(TestDs);
 50 |     
 51 | 如果需要使用命令行参数,则需要创建 ``GDALInfoOptions`` 代码如下:
 52 | 
 53 | .. code-block:: c++
 54 | 
 55 |     GDALAllRegister();
 56 |     //添加命令参数
 57 |     char **argv = NULL;
 58 |     argv = CSLAddString( argv, "-json");
 59 |     argv = CSLAddString( argv, "-hist");
 60 |     GDALInfoOptions *opt = GDALInfoOptionsNew(argv,NULL);
 61 |     GDALDatasetH TestDs = GDALOpen( "testfile.tiff", GA_ReadOnly );
 62 |     char* info = GDALInfo(TestDs,opt);
 63 |     GDALInfoOptionsFree(opt);
 64 |     std::cout<<info<<std::endl;
 65 |     //do something
 66 |     GDALClose(TestDs);
 67 | 
 68 | 
 69 | ****************************************
 70 | gdalwarp
 71 | ****************************************
 72 | 
 73 | :ref:`gdalwarptool`  工具功能可以使用 ``GDALWarp`` 函数实现，具体定义如下:
 74 | 
 75 | .. code-block:: c++
 76 | 
 77 | 
 78 |     /**
 79 |     * @param pszDest      输出路径,或者NULL
 80 |     * @param hDstDS       输出数据集或为NULL(前两参数必须选一)
 81 |     * @param nSrcCount    输入数据集个数
 82 |     * @param pahSrcDS     输入数据集列表
 83 |     * @param psOptionsIn  命令行参数
 84 |     * @param pbUsageError 返回值,标识错误信息
 85 |     * @return  输出数据集(如果hDstDS为NULL,返回的数据集必须使用GDALClose关闭)
 86 |     */
 87 |     GDALDatasetH GDALWarp	(
 88 |         const char * 	pszDest,
 89 |         GDALDatasetH 	hDstDS,
 90 |         int 	nSrcCount,
 91 |         GDALDatasetH * 	pahSrcDS,
 92 |         const GDALWarpAppOptions * 	psOptionsIn,
 93 |         int * 	pbUsageError 
 94 |     )
 95 | 
 96 | 基本使用方式如下:
 97 | 
 98 | .. code-block:: c++
 99 | 
100 |     GDALAllRegister();
101 |     //添加命令参数,每次添加一个!!!
102 |     char **argv = NULL;
103 |     argv = CSLAddString( argv, "-order" );
104 |     argv = CSLAddString( argv, "3" );
105 |     argv = CSLAddString( argv, "-ts" );
106 |     argv = CSLAddString( argv, "1000" );
107 |     argv = CSLAddString( argv, "1000" );
108 |     
109 |     //错误实例!!!!
110 |     //error!!!!
111 |     //////argv = CSLAddString( argv, "-order 3 -ts 1000 1000" );//此写法错误,按照上面写!!!!
112 |     //error!!!!
113 |     
114 |     //返回
115 |     int bUsageError = FALSE;
116 |     //输入列表
117 |     GDALDatasetH TestDs = GDALOpen("test.tif", GA_ReadOnly );
118 |     //gdalwarp
119 |     GDALWarpAppOptions *opt = GDALWarpAppOptionsNew( argv, NULL );
120 |     GDALDataset *dst = ( GDALDataset * )GDALWarp( "out.tif", NULL, 1,\
121 |                        &TestDs ,opt, &bUsageError );
122 |     GDALWarpAppOptionsFree( opt );
123 |     CSLDestroy( argv );
124 |     //do something
125 |     //clear env
126 |     GDALClose(dst);
127 |     GDALClose(TestDs);
128 | 
129 | 
130 | 如果有多个文件输入,使用如下代码:
131 | 
132 | .. code-block:: c++
133 | 
134 |     GDALAllRegister();
135 |     //添加命令参数,每次添加一个!!!
136 |     char **argv = NULL;
137 |     argv = CSLAddString( argv, "-order" );
138 |     argv = CSLAddString( argv, "3" );
139 |     argv = CSLAddString( argv, "-ts" );
140 |     argv = CSLAddString( argv, "1000" );
141 |     argv = CSLAddString( argv, "1000" );
142 |     
143 |     //错误实例!!!!
144 |     //error!!!!
145 |     //////argv = CSLAddString( argv, "-order 3 -ts 1000 1000" );//此写法错误,按照上面写!!!!
146 |     //error!!!!
147 |     
148 |     //返回
149 |     int bUsageError = FALSE;
150 |     //输入列表
151 |     GDALDatasetH TestDs = GDALOpen("test.tif", GA_ReadOnly );
152 |     GDALDatasetH *srcList = NULL;
153 |     srcList = ( GDALDatasetH * ) CPLRealloc( srcList, sizeof( GDALDatasetH ) * 1 );
154 |     srcList[0] = TestDs;//有多少写多少
155 |     //gdalwarp
156 |     GDALWarpAppOptions *opt = GDALWarpAppOptionsNew( argv, NULL );
157 |     GDALDataset *dst = ( GDALDataset * )GDALWarp( "out.tif", NULL, 1,\
158 |                        srcList ,opt, &bUsageError );
159 |     GDALWarpAppOptionsFree( opt );
160 |     CSLDestroy( argv );
161 |     //do something
162 |     //clear env
163 |     GDALClose(dst);
164 |     GDALClose(TestDs);
165 |     CPLFree(srcList);
166 | 
167 | 
168 | ****************************************
169 | gdal_translate
170 | ****************************************
171 | 
172 | :ref:`gdal_translate`  工具功能可以使用 ``GDALTranslate`` 函数实现，具体定义如下:
173 | 
174 | .. code-block:: c++
175 | 
176 | 
177 |     /**
178 |     * @param pszDest      输出路径
179 |     * @param hSrcDataset  输入数据集
180 |     * @param psOptionsIn  命令行参数,可以为空
181 |     * @param pbUsageError 返回值,标识错误信息
182 |     * @return  输出数据集(如果hDstDS为NULL,返回的数据集必须使用GDALClose关闭)
183 |     */
184 |     GDALDatasetH GDALTranslate	(
185 |         const char * 	pszDest,
186 |         GDALDatasetH 	hSrcDataset,
187 |         const GDALTranslateOptions * 	psOptionsIn,
188 |         int * 	pbUsageError 
189 |     )
190 | 
191 | 基本使用方式如下:
192 | 
193 | .. code-block:: c++
194 | 
195 |     GDALAllRegister();
196 |     //添加命令参数,每次添加一个!!!
197 |     char **argv = NULL;
198 |     argv = CSLAddString( argv, "-ot" );
199 |     argv = CSLAddString( argv, "UInt16" );
200 |     
201 |     //错误实例!!!!
202 |     //error!!!!
203 |     //////argv = CSLAddString( argv, "-ot UInt16" );//此写法错误,按照上面写!!!!
204 |     //error!!!!
205 |     
206 |     //返回
207 |     int bUsageError = FALSE;
208 |     //输入列表
209 |     GDALDatasetH TestDs = GDALOpen( "test.tif", GA_ReadOnly );
210 |     //GDALTranslate
211 |     GDALTranslateOptions *opt =  GDALTranslateOptionsNew( argv, NULL );
212 |     GDALDataset *dst = ( GDALDataset * )GDALTranslate( "out.tif", TestDs ,opt, &bUsageError );
213 |     GDALTranslateOptionsFree( opt );
214 |     CSLDestroy( argv );
215 | 
216 | ****************************************
217 | ogr2ogr
218 | ****************************************
219 | 
220 | ``ogr2ogr``  工具功能可以使用 ``GDALVectorTranslate`` 函数实现，具体定义如下:
221 | 
222 | .. code-block:: c++
223 | 
224 | 
225 |     /**
226 |     * @param pszDest      输出路径,或者NULL
227 |     * @param hDstDS       输出数据集或为NULL(前两参数必须选一)
228 |     * @param nSrcCount    输入数据集个数(至2.1.1为止,只能有1个)
229 |     * @param pahSrcDS     输入数据集列表
230 |     * @param psOptionsIn  命令行参数
231 |     * @param pbUsageError 返回值,标识错误信息
232 |     * @return  输出数据集(如果hDstDS为NULL,返回的数据集必须使用GDALClose关闭)
233 |     */
234 |     GDALDatasetH GDALVectorTranslate	(
235 |         const char * 	pszDest,
236 |         GDALDatasetH 	hDstDS,
237 |         int 	nSrcCount,
238 |         GDALDatasetH * 	pahSrcDS,
239 |         const GDALVectorTranslateOptions * 	psOptionsIn,
240 |         int * 	pbUsageError 
241 |     )
242 | 
243 | 基本使用方式如下:
244 | 
245 | .. code-block:: c++
246 | 
247 |     GDALAllRegister();
248 |     //添加命令参数,每次添加一个!!!
249 |     char **argv = NULL;
250 |     argv = CSLAddString( argv, "-f" );
251 |     argv = CSLAddString( argv, "GML" );
252 |     
253 |     //错误实例!!!!
254 |     //error!!!!
255 |     //////argv = CSLAddString( argv, "-f GML" );//此写法错误,按照上面写!!!!
256 |     //error!!!!
257 |     
258 |     //返回
259 |     int bUsageError = FALSE;
260 |     //输入列表
261 |     GDALDatasetH TestDs = GDALOpenEx("test.shp",GDAL_OF_VECTOR, , NULL, NULL, NULL );
262 |     //gdalwarp
263 |     GDALVectorTranslateOptions *opt = GDALVectorTranslateOptionsNew( argv, NULL );
264 |     GDALDataset *dst = ( GDALDataset * )GDALVectorTranslate( "out.gml", NULL, 1, 
265 |                         &TestDs ,opt, &bUsageError );
266 |     GDALVectorTranslateOptionsFree( opt );
267 |     CSLDestroy( argv );
268 |     //do something
269 |     //clear env
270 |     GDALClose(dst);
271 |     GDALClose(TestDs);
272 | 
273 | 
274 | 


--------------------------------------------------------------------------------
/theme/sphinx_rtd_theme/layout.html:
--------------------------------------------------------------------------------
  1 | {# TEMPLATE VAR SETTINGS #}
  2 | {%- set url_root = pathto('', 1) %}
  3 | {%- if url_root == '#' %}{% set url_root = '' %}{% endif %}
  4 | {%- if not embedded and docstitle %}
  5 |   {%- set titlesuffix = " &mdash; "|safe + docstitle|e %}
  6 | {%- else %}
  7 |   {%- set titlesuffix = "" %}
  8 | {%- endif %}
  9 | {%- set lang_attr = 'en' if language == None else (language | replace('_', '-')) %}
 10 | 
 11 | <!DOCTYPE html>
 12 | <!--[if IE 8]><html class="no-js lt-ie9" lang="{{ lang_attr }}" > <![endif]-->
 13 | <!--[if gt IE 8]><!--> <html class="no-js" lang="{{ lang_attr }}" > <!--<![endif]-->
 14 | <head>
 15 |   <meta charset="utf-8">
 16 |   {{ metatags }}
 17 |   <meta name="viewport" content="width=device-width, initial-scale=1.0">
 18 |   {% block htmltitle %}
 19 |   <title>{{ title|striptags|e }}{{ titlesuffix }}</title>
 20 |   {% endblock %}
 21 | 
 22 |   {# FAVICON #}
 23 |   {% if favicon %}
 24 |     <link rel="shortcut icon" href="{{ pathto('_static/' + favicon, 1) }}"/>
 25 |   {% endif %}
 26 |   {# CANONICAL URL #}
 27 |   {% if theme_canonical_url %}
 28 |     <link rel="canonical" href="{{ theme_canonical_url }}{{ pagename }}.html"/>
 29 |   {% endif %}
 30 | 
 31 |   {# CSS #}
 32 | 
 33 |   {# OPENSEARCH #}
 34 |   {% if not embedded %}
 35 |     {% if use_opensearch %}
 36 |       <link rel="search" type="application/opensearchdescription+xml"
 37 |             title="{% trans docstitle=docstitle|e %}Search within {{ docstitle }}{% endtrans %}"
 38 |             href="{{ pathto('_static/opensearch.xml', 1) }}"/>
 39 |     {% endif %}
 40 | 
 41 |   {% endif %}
 42 | 
 43 |   <link rel="stylesheet" href="{{ pathto('_static/' + style, 1) }}" type="text/css" />
 44 |   <link rel="stylesheet" href="{{ pathto('_static/pygments.css', 1) }}" type="text/css" />
 45 |   {%- for css in css_files %}
 46 |     {%- if css|attr("rel") %}
 47 |   <link rel="{{ css.rel }}" href="{{ pathto(css.filename, 1) }}" type="text/css"{% if css.title is not none %} title="{{ css.title }}"{% endif %} />
 48 |     {%- else %}
 49 |   <link rel="stylesheet" href="{{ pathto(css, 1) }}" type="text/css" />
 50 |     {%- endif %}
 51 |   {%- endfor %}
 52 |   {%- for cssfile in extra_css_files %}
 53 |     <link rel="stylesheet" href="{{ pathto(cssfile, 1) }}" type="text/css" />
 54 |   {%- endfor %}
 55 | 
 56 |   {%- block linktags %}
 57 |     {%- if hasdoc('about') %}
 58 |     <link rel="author" title="{{ _('About these documents') }}" href="{{ pathto('about') }}" />
 59 |     {%- endif %}
 60 |     {%- if hasdoc('genindex') %}
 61 |     <link rel="index" title="{{ _('Index') }}" href="{{ pathto('genindex') }}" />
 62 |     {%- endif %}
 63 |     {%- if hasdoc('search') %}
 64 |     <link rel="search" title="{{ _('Search') }}" href="{{ pathto('search') }}" />
 65 |     {%- endif %}
 66 |     {%- if hasdoc('copyright') %}
 67 |     <link rel="copyright" title="{{ _('Copyright') }}" href="{{ pathto('copyright') }}" />
 68 |     {%- endif %}
 69 |     {%- if next %}
 70 |     <link rel="next" title="{{ next.title|striptags|e }}" href="{{ next.link|e }}" />
 71 |     {%- endif %}
 72 |     {%- if prev %}
 73 |     <link rel="prev" title="{{ prev.title|striptags|e }}" href="{{ prev.link|e }}" />
 74 |     {%- endif %}
 75 |   {%- endblock %}
 76 |   {%- block extrahead %} {% endblock %}
 77 | 
 78 |   {# Keep modernizr in head - http://modernizr.com/docs/#installing #}
 79 |   <script src="{{ pathto('_static/js/modernizr.min.js', 1) }}"></script>
 80 | 
 81 | </head>
 82 | 
 83 | <body class="wy-body-for-nav">
 84 | 
 85 |   {% block extrabody %} {% endblock %}
 86 |   <div class="wy-grid-for-nav">
 87 | 
 88 |     {# SIDE NAV, TOGGLES ON MOBILE #}
 89 |     <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 90 |       <div class="wy-side-scroll">
 91 |         <div class="wy-side-nav-search">
 92 |           {% block sidebartitle %}
 93 | 
 94 |           {% if logo and theme_logo_only %}
 95 |             <a href="{{ pathto(master_doc) }}">
 96 |           {% else %}
 97 |             <a href="{{ pathto(master_doc) }}" class="icon icon-home"> {{ project }}
 98 |           {% endif %}
 99 | 
100 |           {% if logo %}
101 |             {# Not strictly valid HTML, but it's the only way to display/scale
102 |                it properly, without weird scripting or heaps of work
103 |             #}
104 |             <img src="{{ pathto('_static/' + logo, 1) }}" class="logo" alt="Logo"/>
105 |           {% endif %}
106 |           </a>
107 | 
108 |           {% if theme_display_version %}
109 |             {%- set nav_version = version %}
110 |             {% if READTHEDOCS and current_version %}
111 |               {%- set nav_version = current_version %}
112 |             {% endif %}
113 |             {% if nav_version %}
114 |               <div class="version">
115 |                 {{ nav_version }}
116 |               </div>
117 |             {% endif %}
118 |           {% endif %}
119 | 
120 |           {% include "searchbox.html" %}
121 | 
122 |           {% endblock %}
123 |         </div>
124 | 
125 |         <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
126 |           {% block menu %}
127 |             {#
128 |               The singlehtml builder doesn't handle this toctree call when the
129 |               toctree is empty. Skip building this for now.
130 |             #}
131 |             {% if 'singlehtml' not in builder %}
132 |               {% set global_toc = toctree(maxdepth=theme_navigation_depth|int,
133 |                                           collapse=theme_collapse_navigation|tobool,
134 |                                           includehidden=theme_includehidden|tobool,
135 |                                           titles_only=theme_titles_only|tobool) %}
136 |             {% endif %}
137 |             {% if global_toc %}
138 |               {{ global_toc }}
139 |             {% else %}
140 |               <!-- Local TOC -->
141 |               <div class="local-toc">{{ toc }}</div>
142 |             {% endif %}
143 |           {% endblock %}
144 |         </div>
145 |       </div>
146 |     </nav>
147 | 
148 |     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
149 | 
150 |       {# MOBILE NAV, TRIGGLES SIDE NAV ON TOGGLE #}
151 |       <nav class="wy-nav-top" aria-label="top navigation">
152 |         {% block mobile_nav %}
153 |           <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
154 |           <a href="{{ pathto(master_doc) }}">{{ project }}</a>
155 |         {% endblock %}
156 |       </nav>
157 | 
158 | 
159 |       <div class="wy-nav-content">
160 |       {%- block content %}
161 |         {% if theme_style_external_links|tobool %}
162 |         <div class="rst-content style-external-links">
163 |         {% else %}
164 |         <div class="rst-content">
165 |         {% endif %}
166 |           {% include "breadcrumbs.html" %}
167 |           <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
168 |           {%- block document %}
169 |            <div itemprop="articleBody">
170 |             {% block body %}{% endblock %}
171 |            </div>
172 |            {% if self.comments()|trim %}
173 |            <div class="articleComments">
174 |             {% block comments %}{% endblock %}
175 |            </div>
176 |            {% endif%}
177 |           </div>
178 |           {%- endblock %}
179 |           {% include "footer.html" %}
180 |         </div>
181 |       {%- endblock %}
182 |       </div>
183 | 
184 |     </section>
185 | 
186 |   </div>
187 |   {% include "versions.html" %}
188 | 
189 |   {% if not embedded %}
190 | 
191 |     <script type="text/javascript">
192 |         var DOCUMENTATION_OPTIONS = {
193 |             URL_ROOT:'{{ url_root }}',
194 |             VERSION:'{{ release|e }}',
195 |             LANGUAGE:'{{ language }}',
196 |             COLLAPSE_INDEX:false,
197 |             FILE_SUFFIX:'{{ '' if no_search_suffix else file_suffix }}',
198 |             HAS_SOURCE:  {{ has_source|lower }},
199 |             SOURCELINK_SUFFIX: '{{ sourcelink_suffix }}'
200 |         };
201 |     </script>
202 |     {%- for scriptfile in script_files %}
203 |       <script type="text/javascript" src="{{ pathto(scriptfile, 1) }}"></script>
204 |     {%- endfor %}
205 | 
206 |   {% endif %}
207 | 
208 |   <script type="text/javascript" src="{{ pathto('_static/js/theme.js', 1) }}"></script>
209 | 
210 |   <script type="text/javascript">
211 |       jQuery(function () {
212 |           SphinxRtdTheme.Navigation.enable({{ 'true' if theme_sticky_navigation|tobool else 'false' }});
213 |       });
214 |   </script>
215 | 
216 |   {%- block footer %} {% endblock %}
217 | 
218 | </body>
219 | </html>
220 | 


--------------------------------------------------------------------------------
/sqlite-sql.rst:
--------------------------------------------------------------------------------
  1 | .. highlight:: rst
  2 | .. _SQLitesql:.. _SQLitesql:
  3 | 
  4 | .. _SQLitesql:
  5 | 
  6 | ############################
  7 | SQLite SQL
  8 | ############################
  9 | 本章来源:
 10 |  
 11 | * SQLite: `SQLite SQL dialect <http://www.gdal.org/ogr_sql_sqlite.html>`_  
 12 | * SpatiaLite: `SpatiaLite 4.3.0 SQL functions reference list  <http://www.gaia-gis.it/gaia-sins/spatialite-sql-4.3.0.html>`_
 13 | 
 14 | ********************
 15 | 简介
 16 | ********************
 17 | 
 18 | GDAL 1.10 版本后,可以使用 Sqlite 语法代替 ogrsql 语法.大部分语法支持都需要Spatialite库. 执行方式同样调用 GDALDataset::ExecuteSQL()  ,但是需要指定 pszDialect 参数为 "SQLITE".
 19 | 
 20 | ********************
 21 | SELECT statement
 22 | ********************
 23 | 
 24 | 简单 select 语句如下:
 25 | 
 26 | .. image:: img/simple-select-stmt.png
 27 |    :alt: simple select statement
 28 |    :align: center
 29 | 
 30 | 
 31 | select 语法图如下:
 32 | 
 33 | .. image:: img/select-stmt.png
 34 |    :alt: select statement
 35 |    :align: center
 36 |  
 37 |  
 38 | join 语法如下:
 39 | 
 40 | .. image:: img/join-clause.png
 41 |    :alt: join clause
 42 |    :align: center
 43 | 
 44 | ********************
 45 | Spatialite SQL 
 46 | ********************
 47 | 可以参考网站 `SpatiaLite 4.3.0 SQL functions reference list  <http://www.gaia-gis.it/gaia-sins/spatialite-sql-4.3.0.html>`_ 上的说明,下面列出来几个常用的,需要GEOS库支持
 48 | 
 49 | SQL functions that implement spatial operators
 50 | 
 51 | 
 52 | 
 53 | +---------------+---------------------------------------------------------------+-------------+
 54 | | Function      |                       Syntax                                  |   Summary   |
 55 | +===============+===============================================================+=============+
 56 | | Intersection  || Intersection( geom1 Geometry , geom2 Geometry )              |   两物求交  |
 57 | |               || :Geometry                                                    |             |
 58 | |               +---------------------------------------------------------------+             |
 59 | |               || ST_Intersection( geom1 Geometry , geom2 Geometry )           |             |
 60 | |               || :Geometry                                                    |             |
 61 | +---------------+---------------------------------------------------------------+-------------+
 62 | | Difference    || Difference( geom1 Geometry , geom2 Geometry )                |   两物求差  |
 63 | |               || :Geometry                                                    |             |
 64 | |               +---------------------------------------------------------------+             |
 65 | |               || ST_Difference( geom1 Geometry , geom2 Geometry )             |             |
 66 | |               || :Geometry                                                    |             |
 67 | +---------------+---------------------------------------------------------------+-------------+
 68 | | GUnion        | GUnion( geom1 Geometry , geom2 Geometry ) : Geometry          |   两物求并  |
 69 | |               +---------------------------------------------------------------+             |
 70 | |               | ST_Union( geom1 Geometry , geom2 Geometry ) : Geometry        |             |
 71 | +---------------+---------------------------------------------------------------+-------------+
 72 | | GUnion        | GUnion( geom1 Geometry ) : Geometry                           |  整体求并   |
 73 | |               +---------------------------------------------------------------+             |
 74 | |               | ST_Union( geom1 Geometry ) : Geometry                         |             |
 75 | +---------------+---------------------------------------------------------------+-------------+
 76 | | Collect       | Collect( geom1 Geometry , geom2 Geometry ) : Geometry         |   合并两者  |
 77 | |               +---------------------------------------------------------------+             |
 78 | |               | ST_Collect( geom1 Geometry , geom2 Geometry ):Geometry        |             |
 79 | +---------------+---------------------------------------------------------------+-------------+
 80 | | Collect       |  Collect( geom Geometry ) : Geometry                          |  合并集合   |
 81 | |               +---------------------------------------------------------------+             |
 82 | |               |  ST_Collect( geom Geometry ) : Geometry                       |             |
 83 | +---------------+---------------------------------------------------------------+-------------+
 84 | 
 85 | 
 86 | 
 87 | +---------------+-------------------------------------------------------+-------------+
 88 | | Function      |                      Syntax                           |   Summary   |
 89 | +===============+=======================================================+=============+
 90 | | SymDifference || SymDifference( geom1 Geometry ,                      || 两物       |
 91 | |               || geom2 Geometry ):Geometry                            || 逻辑或     |
 92 | |               +-------------------------------------------------------+             |
 93 | |               || ST_SymDifference(geom1 Geometry                      |             |
 94 | |               || ,geom2 Geometry ):Geometry                           |             |
 95 | +---------------+-------------------------------------------------------+-------------+
 96 | | Buffer        | | Buffer( geom Geometry , dist Double precision[,     |    缓冲区   |
 97 | |               | | quadrantsegments int] ):Geometry                    |             |
 98 | |               +-------------------------------------------------------+             |
 99 | |               | | ST_Buffer( geom Geometry , dist Double precision[,  |             |
100 | |               | | quadrantsegments int] ):Geometry                    |             |
101 | +---------------+-------------------------------------------------------+-------------+
102 | | | Hausdorff   || HausdorffDistance( geom1 Geometry , geom2 Geometry ) |豪斯多夫距离 |
103 | | | Distance    || : Double precision                                   |             |
104 | |               +-------------------------------------------------------+             |
105 | |               || ST_HausdorffDistance( geom1 Geometry, geom2 Geometry)|             |
106 | |               || :Double precision                                    |             |
107 | +---------------+-------------------------------------------------------+-------------+
108 | | OffestCurve   || OffsetCurve( geom Curve , radius                     | | 偏移曲线  |
109 | |               ||  Double precision ) :Curve                           | | 正左负右  |
110 | |               +-------------------------------------------------------+             |
111 | |               || ST_OffsetCurve( geom Curve ,                         |             |
112 | |               || radius Double precision): Curve                      |             |
113 | +---------------+-------------------------------------------------------+-------------+
114 | | Snap          || Snap( geom1 Geometry , geom2 Geometry , tolerance    |   咬合1到2  |
115 | |               || Double precision ) : Geometry                        |             |
116 | |               +-------------------------------------------------------+             |
117 | |               || ST_Snap( geom1 Geometry , geom2 Geometry , tolerance |             |
118 | |               || Double precision ) : Geometry                        |             |
119 | +---------------+-------------------------------------------------------+-------------+
120 | 
121 | 
122 | 
123 | 
124 | +---------------+-------------------------------------------------------+-------------+
125 | | Function      |                      Syntax                           |   Summary   |
126 | +===============+=======================================================+=============+
127 | | | Dissolve    |  DissolveSegments( geom Geometry ) : Geometry         || 溶合线段   |
128 | | | Segments    +-------------------------------------------------------+| 点不会动   |
129 | |               |  ST_DissolveSegments( geom Geometry ) : Geometry      || 环被拆分   |
130 | +---------------+-------------------------------------------------------+-------------+
131 | || Delaunay     || DelaunayTriangulation( geom Geometry [ , edges_only  | 德拉尼三角网|
132 | || Triangulation|| Boolean [ , tolerance Double precision ]]) : Geometry|             |
133 | |               +-------------------------------------------------------+             |
134 | |               || ST_DelaunayTriangulation( geom Geometry [, edges_only|             |
135 | |               || Boolean [ , tolerance Double precision ] ]): Geometry|             |
136 | +---------------+-------------------------------------------------------+-------------+
137 | |VoronojDiagram || VoronojDiagram( geom Geometry [, edges_only Boolean [|  Voronoj图  |
138 | |               || , frame_extra_size Double precision [ , tolerance    |             |
139 | |               || Double precision ] ] ] ) : Geometry                  |             |
140 | |               +-------------------------------------------------------+             |
141 | |               || ST_VoronojDiagram( geom Geometry[, edges_only Boolean|             |
142 | |               || [ , frame_extra_size Double precision [ , tolerance  |             |
143 | |               || Double precision ] ] ] ) : Geometry                  |             |
144 | +---------------+-------------------------------------------------------+-------------+
145 | | ConvexHull    | ConvexHull( geom Geometry ) : Geometry                |    凸包     |
146 | |               +-------------------------------------------------------+             |
147 | |               | ST_ConvexHull( geom Geometry ) : Geometry             |             |
148 | +---------------+-------------------------------------------------------+-------------+
149 | |   ConcaveHull || ConcaveHull( geom Geometry [, factor Double precision|  凹包       |
150 | |               || [ , allow_holes Boolean [, tolerance Double precision|             |
151 | |               || ] ] ] ) : Geometry                                   |             |
152 | |               +-------------------------------------------------------+             |
153 | |               || ST_ConcaveHull( geom Geometry [ , factor Double      |             |
154 | |               || precision [, allow_holes Boolean [ , tolerance Double|             |
155 | |               || precision ] ] ] ) : Geometry                         |             |
156 | +---------------+-------------------------------------------------------+-------------+
157 | 


--------------------------------------------------------------------------------
/ogr-proj.rst:
--------------------------------------------------------------------------------
  1 | .. highlight:: rst
  2 | .. _OGRProj:
  3 | 
  4 | ############################
  5 | OGR投影简介
  6 | ############################
  7 | 本章来源： `OGR Projections Tutorial <http://www.gdal.org/osr_tutorial.html>`_
  8 | 
  9 | ********************
 10 | 简介
 11 | ********************
 12 | ``OGRSpatialReference`` ，和 ``OGRCoordinateTransformation`` 类提供的表达坐标系统（投影和基准面）和它们之间的变换的接口。这些服务是仿照OpenGIS规范的坐标变换，并使用WKT格式描述的坐标系统。
 13 | 
 14 | `Simple Features for COM <http://www.opengeospatial.org/standards/sfo/>`_ 中可以找到 ``OpenGIS`` 坐标系统和服务的介绍， ``Spatial Reference Systems Abstract Model`` 的介绍可以在 `OGC <http://www.opengeospatial.org/>`_ 网站上找到。 `GeoTIFF Projections Transform List <http://www.remotesensing.org/geotiff/proj_list/>`_ 中也可以找到WKT的一些说明。 `EPSG Geodesy <http://www.epsg.org/>`_ 网站上的资源也非常有用.
 15 | 
 16 | ********************
 17 | 定义地理坐标系
 18 | ********************
 19 | 坐标系统被封装在  ``OGRSpatialReference`` 类中。有许多方法将 ``OGRSpatialReference`` 对象初始化为一个有效的坐标系统。有两种主要的坐标系统，地理坐标系（经纬度投影）和投影坐标系（如UTM，单位为米或英尺）。
 20 | 
 21 | 地理坐标系统包含的基准面信息（半长轴，扁率），本初子午线（通常是格林尼治），和单位类型（通常是度）。下面的代码是地理坐标系统实例::
 22 | 
 23 |     OGRSpatialReference oSRS;
 24 |     oSRS.SetGeogCS( "My geographic coordinate system",
 25 |                     "WGS_1984", 
 26 |                     "My WGS84 Spheroid", 
 27 |                     SRS_WGS84_SEMIMAJOR, SRS_WGS84_INVFLATTENING, 
 28 |                     "Greenwich", 0.0, 
 29 |                     "degree", SRS_UA_DEGREE_CONV );
 30 | 
 31 | 上面的代码中，“My geographic coordinate system”、“My WGS84 Spheroid”、“Greenwich”和“degree”不是关键，主要用于向用户显示投影信息。然而，“WGS_1984” 作为确定基准面的关键，是需要遵循一定规则的。
 32 | 
 33 | OGRSpatialReference中已有很多的坐标系统的支持，其中包括“NAD27”、“NAD83”、“wgs72”和“WGS84”等，可以直接调用SetWellKnownGeogCS()获取
 34 | 
 35 | .. code-block:: c++
 36 | 
 37 |     oSRS.SetWellKnownGeogCS( "WGS84" );
 38 | 
 39 | 此外，可以使用EPSG数据库中的GCS码数表示投影
 40 | 
 41 | .. code-block:: c++
 42 | 
 43 |     oSRS.SetWellKnownGeogCS( "EPSG:4326" );
 44 |     
 45 | ``OGRSpatialReference`` 可以调用函数将投影序列化,转为WKT串或者其他形式输出。
 46 | 
 47 | .. code-block:: c++
 48 | 
 49 |     char    *pszWKT = NULL;
 50 |     oSRS.SetWellKnownGeogCS( "WGS84" );
 51 |     oSRS.exportToWkt( &pszWKT );
 52 |     printf( "%s\n", pszWKT );
 53 | 
 54 | 输出为::
 55 | 
 56 |     GEOGCS["WGS 84",
 57 |         DATUM["WGS_1984",
 58 |             SPHEROID["WGS 84",6378137,298.257223563,
 59 |                 AUTHORITY["EPSG",7030]],
 60 |             TOWGS84[0,0,0,0,0,0,0],
 61 |             AUTHORITY["EPSG",6326]],
 62 |         PRIMEM["Greenwich",0,AUTHORITY["EPSG",8901]],
 63 |         UNIT["DMSH",0.0174532925199433,AUTHORITY["EPSG",9108]],
 64 |         AXIS["Lat",NORTH],
 65 |         AXIS["Long",EAST],
 66 |         AUTHORITY["EPSG",4326]]
 67 | 
 68 | ``OGRSpatialReference::importFromWkt()`` 方法可以用WKT坐标系统定义。
 69 | 
 70 | ********************
 71 | 投影坐标系
 72 | ********************
 73 | 投影坐标系统（如UTM、Lambert Conformal Conic等）默认包含了一个地理坐标系统，以及一个平面坐标与地理坐标相互转换的描述。下面的代码定义了一个UTM 17号带投影，默认为WGS84地理坐标系统。
 74 | 
 75 | .. code-block:: c++
 76 | 
 77 |     OGRSpatialReference     oSRS;
 78 |     oSRS.SetProjCS( "UTM 17 (WGS84) in northern hemisphere." );
 79 |     oSRS.SetWellKnownGeogCS( "WGS84" );
 80 |     oSRS.SetUTM( 17, TRUE );
 81 | 
 82 | 调用 ``SetProjCS()`` 函数 设置投影名称。``SetWellKnownGeogCS() `` 设置地理坐标系统， ``SetUTM()`` 设置详细的投影变换参数。在现有版本中，上述步骤顺序不可颠倒，否则无法生成有效投影。
 83 | 
 84 | 上述定义将WKT版本如下。请注意，UTM 17 在描述参数中被定义::
 85 | 
 86 |     PROJCS["UTM 17 (WGS84) in northern hemisphere.",
 87 |         GEOGCS["WGS 84",
 88 |             DATUM["WGS_1984",
 89 |                 SPHEROID["WGS 84",6378137,298.257223563,
 90 |                     AUTHORITY["EPSG",7030]],
 91 |                 TOWGS84[0,0,0,0,0,0,0],
 92 |                 AUTHORITY["EPSG",6326]],
 93 |             PRIMEM["Greenwich",0,AUTHORITY["EPSG",8901]],
 94 |             UNIT["DMSH",0.0174532925199433,AUTHORITY["EPSG",9108]],
 95 |             AXIS["Lat",NORTH],
 96 |             AXIS["Long",EAST],
 97 |             AUTHORITY["EPSG",4326]],
 98 |         PROJECTION["Transverse_Mercator"],
 99 |         PARAMETER["latitude_of_origin",0],
100 |         PARAMETER["central_meridian",-81],
101 |         PARAMETER["scale_factor",0.9996],
102 |         PARAMETER["false_easting",500000],
103 |         PARAMETER["false_northing",0]]
104 |         
105 | 有许多投影方法包括settm()方法（横轴），setlcc()（Lambert Conformal Conic），和setmercator()。
106 | 
107 | ********************
108 | 查询坐标系统
109 | ********************
110 | 一旦一个 ``OGRSpatialReference`` 已经建立，它的信息可以被查询。 
111 | 
112 | * ``OGRSpatialReference::IsProjected()`` ``OGRSpatialReference::IsGeographic()`` 函数确定投影类型
113 | * ``OGRSpatialReference::GetSemiMajor()`` , ``OGRSpatialReference::GetSemiMinor()``   ``OGRSpatialReference::GetInvFlattening()`` 方法可用于获取有关球体的信息。
114 | *  ``OGRSpatialReference::GetAttrValue()``  方法可以用来获得projcs，geogcs，基准，球体，和投影名称的字符串
115 | * ``OGRSpatialReference::GetProjParm()`` 方法可用于获取投影参数。 
116 | * ``OGRSpatialReference::GetLinearUnits()`` 方法可用于获取投影的单位,可以转化到米。
117 | 
118 | 下面的代码演示了如何获取信息:
119 | 
120 | .. code-block:: c++
121 | 
122 |     const char *pszProjection = poSRS->GetAttrValue("PROJECTION");
123 |     if( pszProjection == NULL )
124 |     {
125 |         if( poSRS->IsGeographic() )
126 |             sprintf( szProj4+strlen(szProj4), "+proj=longlat " );
127 |         else
128 |             sprintf( szProj4+strlen(szProj4), "unknown " );
129 |     }
130 |     else if( EQUAL(pszProjection,SRS_PT_CYLINDRICAL_EQUAL_AREA) )
131 |     {
132 |         sprintf( szProj4+strlen(szProj4),
133 |            "+proj=cea +lon_0=%.9f +lat_ts=%.9f +x_0=%.3f +y_0=%.3f ",
134 |                  poSRS->GetProjParm(SRS_PP_CENTRAL_MERIDIAN,0.0),
135 |                  poSRS->GetProjParm(SRS_PP_STANDARD_PARALLEL_1,0.0),
136 |                  poSRS->GetProjParm(SRS_PP_FALSE_EASTING,0.0),
137 |                  poSRS->GetProjParm(SRS_PP_FALSE_NORTHING,0.0) );
138 |     }
139 |     ...
140 | 
141 | 
142 | ********************
143 | 坐标转换
144 | ********************
145 | ``OGRCoordinateTransformation`` 类用于不同坐标系之间的转换。使用 ``OGRCreateCoordinateTransformation()``  创建转换对象，然后调用 ``OGRCoordinateTransformation::Transform()`` 方法转换坐标。
146 | 
147 | .. code-block:: c++
148 | 
149 |     OGRSpatialReference oSourceSRS, oTargetSRS;
150 |     OGRCoordinateTransformation *poCT;
151 |     double x, y;
152 | 
153 |     oSourceSRS.importFromEPSG( atoi( papszArgv[i + 1] ) );
154 |     oTargetSRS.importFromEPSG( atoi( papszArgv[i + 2] ) );
155 | 
156 |     poCT = OGRCreateCoordinateTransformation( &oSourceSRS,
157 |            &oTargetSRS );
158 |     x = atof( papszArgv[i + 3] );
159 |     y = atof( papszArgv[i + 4] );
160 | 
161 |     if( poCT == NULL || !poCT->Transform( 1, &x, &y ) )
162 |     {
163 |       printf( "Transformation failed.\n" );
164 |     } else {
165 |       printf( "(%f,%f) -> (%f,%f)\n",
166 |               atof( papszArgv[i + 3] ),
167 |               atof( papszArgv[i + 4] ),
168 |               x, y );
169 |     }
170 | 
171 | 投影转换失败可能原因如下:
172 | 
173 | * ``OGRCreateCoordinateTransformation()``  可能会失败，一般是因为系统之间可以建立没有变换。这可能是由于PROJ.4库不支持。如果 ``OGRCreateCoordinateTransformation()`` 失败，它将返回一个null。
174 | * ``OGRCoordinateTransformation::Transform()`` 方法本身也会失败。
175 | 
176 | 上述代码中没有演示三维点转换，但是该函数是可以用于三维点转换的，如果没有传入Z值，假设点在大地水准面上。
177 | 
178 | 下面的示例演示如何方便地创建一个纬度/经度坐标系统使用相同的地理坐标系统和投影坐标系，并利用这些投影坐标和经纬度之间的转换。
179 | 
180 | .. code-block:: c++
181 | 
182 |     OGRSpatialReference    oUTM, *poLatLong;
183 |     OGRCoordinateTransformation *poTransform;
184 |     oUTM.SetProjCS("UTM 17 / WGS84");
185 |     oUTM.SetWellKnownGeogCS( "WGS84" );
186 |     oUTM.SetUTM( 17 );
187 |     poLatLong = oUTM.CloneGeogCS();
188 |     poTransform = OGRCreateCoordinateTransformation( &oUTM, poLatLong );
189 |     if( poTransform == NULL )
190 |     {
191 |         ...
192 |     }
193 |     ...
194 |     if( !poTransform->Transform( nPoints, x, y, z ) )
195 | 
196 | ********************
197 | 其他语言接口
198 | ********************
199 | C接口定义的坐标系统服务 ``ogr_srs_api.h`` ，和Python绑定可以通过 ``osr.py`` 模块。其他语言用法类似c++，但是缺少一些方法。
200 | 
201 | .. code-block:: c
202 | 
203 |     typedef void *OGRSpatialReferenceH;                               
204 |     typedef void *OGRCoordinateTransformationH;
205 |     OGRSpatialReferenceH OSRNewSpatialReference( const char * );
206 |     void    OSRDestroySpatialReference( OGRSpatialReferenceH );
207 |     int     OSRReference( OGRSpatialReferenceH );
208 |     int     OSRDereference( OGRSpatialReferenceH );
209 |     OGRErr  OSRImportFromEPSG( OGRSpatialReferenceH, int );
210 |     OGRErr  OSRImportFromWkt( OGRSpatialReferenceH, char ** );
211 |     OGRErr  OSRExportToWkt( OGRSpatialReferenceH, char ** );
212 |     OGRErr  OSRSetAttrValue( OGRSpatialReferenceH hSRS, const char * pszNodePath,
213 |                              const char * pszNewNodeValue );
214 |     const char *OSRGetAttrValue( OGRSpatialReferenceH hSRS,
215 |                                  const char * pszName, int iChild);
216 |     OGRErr  OSRSetLinearUnits( OGRSpatialReferenceH, const char *, double );
217 |     double  OSRGetLinearUnits( OGRSpatialReferenceH, char ** );
218 |     int     OSRIsGeographic( OGRSpatialReferenceH );
219 |     int     OSRIsProjected( OGRSpatialReferenceH );
220 |     int     OSRIsSameGeogCS( OGRSpatialReferenceH, OGRSpatialReferenceH );
221 |     int     OSRIsSame( OGRSpatialReferenceH, OGRSpatialReferenceH );
222 |     OGRErr  OSRSetProjCS( OGRSpatialReferenceH hSRS, const char * pszName );
223 |     OGRErr  OSRSetWellKnownGeogCS( OGRSpatialReferenceH hSRS,
224 |                                    const char * pszName );
225 |     OGRErr  OSRSetGeogCS( OGRSpatialReferenceH hSRS,
226 |                           const char * pszGeogName,
227 |                           const char * pszDatumName,
228 |                           const char * pszEllipsoidName,
229 |                           double dfSemiMajor, double dfInvFlattening,
230 |                           const char * pszPMName ,
231 |                           double dfPMOffset ,
232 |                           const char * pszUnits,
233 |                           double dfConvertToRadians );
234 |     double  OSRGetSemiMajor( OGRSpatialReferenceH, OGRErr * );
235 |     double  OSRGetSemiMinor( OGRSpatialReferenceH, OGRErr * );
236 |     double  OSRGetInvFlattening( OGRSpatialReferenceH, OGRErr * );
237 |     OGRErr  OSRSetAuthority( OGRSpatialReferenceH hSRS,
238 |                              const char * pszTargetKey,
239 |                              const char * pszAuthority,
240 |                              int nCode );
241 |     OGRErr  OSRSetProjParm( OGRSpatialReferenceH, const char *, double );
242 |     double  OSRGetProjParm( OGRSpatialReferenceH hSRS,
243 |                             const char * pszParmName, 
244 |                             double dfDefault,
245 |                             OGRErr * );
246 |     OGRErr  OSRSetUTM( OGRSpatialReferenceH hSRS, int nZone, int bNorth );
247 |     int     OSRGetUTMZone( OGRSpatialReferenceH hSRS, int *pbNorth );
248 |     OGRCoordinateTransformationH
249 |     OCTNewCoordinateTransformation( OGRSpatialReferenceH hSourceSRS,
250 |                                     OGRSpatialReferenceH hTargetSRS );
251 |     void OCTDestroyCoordinateTransformation( OGRCoordinateTransformationH );
252 |     int OCTTransform( OGRCoordinateTransformationH hCT,
253 |                       int nCount, double *x, double *y, double *z );
254 | 
255 | Python 接口:
256 | 
257 | .. code-block:: python
258 | 
259 |     class osr.SpatialReference
260 |         def __init__(self,obj=None):
261 |         def ImportFromWkt( self, wkt ):
262 |         def ExportToWkt(self):
263 |         def ImportFromEPSG(self,code):
264 |         def IsGeographic(self):
265 |         def IsProjected(self):
266 |         def GetAttrValue(self, name, child = 0):
267 |         def SetAttrValue(self, name, value):
268 |         def SetWellKnownGeogCS(self, name):
269 |         def SetProjCS(self, name = "unnamed" ):
270 |         def IsSameGeogCS(self, other):
271 |         def IsSame(self, other):
272 |         def SetLinearUnits(self, units_name, to_meters ):
273 |         def SetUTM(self, zone, is_north = 1):
274 |     class CoordinateTransformation:
275 |         def __init__(self,source,target):
276 |         def TransformPoint(self, x, y, z = 0):
277 |         def TransformPoints(self, points):
278 | 
279 | ********************
280 | 内部实现
281 | ********************
282 | 
283 | 内部实现基于 ``PROJ.4`` 库,接口为 ``OGRCoordinateTransformation``


--------------------------------------------------------------------------------
/ogr-utilities.rst:
--------------------------------------------------------------------------------
  1 | .. highlight:: rst
  2 | .. _OGRUtilities:
  3 | 
  4 | ############################
  5 | OGR工具集
  6 | ############################
  7 | 主要来自 `OGR Utility Programs <http://www.gdal.org/ogr_utilities.html>`_
  8 | 
  9 | ********************
 10 | 通用选项
 11 | ********************
 12 | 所有ogr工具通用选项
 13 | 
 14 | .. program:: ogr
 15 | 
 16 | .. cmdoption:: --version
 17 | 
 18 |         返回GDAL版本.
 19 | 
 20 | .. cmdoption:: --formats
 21 | 
 22 |         返回所有支持的格式.
 23 | 
 24 | .. cmdoption:: --format format
 25 | 
 26 |         某种格式的详细信息.
 27 | 
 28 | .. cmdoption:: --optfile file
 29 | 
 30 |         将一个文件中的内容作为工具参数列表.
 31 | 
 32 | .. cmdoption:: --config key value
 33 | 
 34 |         设置系统参数.
 35 | 
 36 | .. cmdoption:: --debug value
 37 | 
 38 |         设置debug级别.
 39 | 
 40 | .. cmdoption:: --help-general
 41 | 
 42 |         显示通用选项.
 43 | 
 44 | ********************
 45 | ogrinfo
 46 | ********************
 47 | ``ogrinfo`` 主要用来显示矢量数据的所有信息,也可以用sql操作矢量, ``ogrinfo`` 命令打开文件默认为读写方式打开,部分只读驱动会发出警告,用法如下::
 48 | 
 49 |     ogrinfo [--help-general] [-ro] [-q] [-where restricted_where|\@filename]
 50 |             [-spat xmin ymin xmax ymax] [-geomfield field] [-fid fid]
 51 |             [-sql statement|\@filename] [-dialect dialect] [-al] [-so] [-fields={YES/NO}]
 52 |             [-geom={YES/NO/SUMMARY/WKT/ISO_WKT}] [-formats] [[-oo NAME=VALUE] ...]
 53 |             [-nomd] [-listmdd] [-mdd domain|`all`]*
 54 |             [-nocount] [-noextent]
 55 |             datasource_name [layer [layer ...]]
 56 | 
 57 | 参数说明:
 58 | 
 59 | .. program:: ogrinfo
 60 | 
 61 | .. cmdoption:: -ro:
 62 | 
 63 |     以只读方式打开数据集.
 64 | 
 65 | .. cmdoption:: -al:
 66 | 
 67 |     列出所有图层的所有要素 (used instead of having to give layer names as arguments).
 68 | 
 69 | .. cmdoption:: -so:
 70 |     
 71 |     仅列出摘要:只列出部分要素,只显示投影/要素数量和边界范围等基本信息
 72 |     
 73 | .. cmdoption:: -q:
 74 |     
 75 |     隐藏提示信息.
 76 | 
 77 | .. cmdoption:: -where restricted_where:
 78 | 
 79 |     用 sql where 语句限定范围,仅输出查询部分的要素信息,GDAL2.1后可以使用 ``\filename`` 语法
 80 |     
 81 | .. cmdoption:: -sql statement:
 82 | 
 83 |     执行SQL语句.GDAL2.1以后,可以使用 ``@filename`` 语法指定针对文件查询
 84 |     
 85 | .. cmdoption:: -dialect dialect:
 86 | 
 87 |     特定SQL语法类型 OGRSQL 或 SQLITE .
 88 | 
 89 | .. cmdoption:: -spat xmin ymin xmax ymax:
 90 | 
 91 |     感兴趣区域范围,仅显示指定范围内容
 92 | 
 93 | .. cmdoption:: -geomfield field:
 94 | 
 95 |     指定 ``geometry`` 字段名字,用于空间条件过滤查询.
 96 | 
 97 | .. cmdoption:: -fid fid:
 98 | 
 99 |     指定查询的 ``feature id``
100 | 
101 | .. cmdoption:: -fields={YES/NO}:
102 | 
103 |     如果设置为NO,则不显示feature的字段值.
104 |     
105 | .. cmdoption:: -geom={YES/NO/SUMMARY/WKT/ISO_WKT}:
106 | 
107 |     如何显示geometry,默认为YES,显示为WKT字符串
108 | 
109 | .. cmdoption:: -oo NAME=VALUE:
110 | 
111 |     数据集的打开选项(GDAL 2.0)
112 | 
113 | .. cmdoption:: -nomd
114 | 
115 |     (GDAL 2.0) 不显示元数据
116 |     
117 | .. cmdoption:: -listmdd
118 |     
119 |     (GDAL 2.0)显示所有元数据.
120 |     
121 | .. cmdoption:: -mdd domain
122 | 
123 |     (GDAL 2.0) 显示指定元数据信息
124 |     
125 | .. cmdoption:: -nocount
126 |     
127 |     ( GDAL 2.0) 不显示要素数量.
128 |     
129 | .. cmdoption:: -noextent
130 | 
131 |     (GDAL 2.0) 不显示图层范围.
132 | 
133 | .. cmdoption:: datasource_name:
134 | 
135 |     数据集名称
136 |     
137 | .. cmdoption:: layer:
138 | 
139 |     一个或多个图层名
140 |     
141 | ********************
142 | ogr2ogr
143 | ********************
144 | ``ogr2ogr`` 主要用于矢量格式转换,属性设置,重投影等,用法如下::
145 | 
146 |     Usage: ogr2ogr [--help-general] [-skipfailures] [-append] [-update]
147 |                    [-select field_list] [-where restricted_where|\@filename] 
148 |                    [-progress] [-sql <sql statement>|\@filename] [-dialect dialect]
149 |                    [-preserve_fid] [-fid FID]
150 |                    [-spat xmin ymin xmax ymax] [-spat_srs srs_def] [-geomfield field]
151 |                    [-a_srs srs_def] [-t_srs srs_def] [-s_srs srs_def]
152 |                    [-f format_name] [-overwrite] [[-dsco NAME=VALUE] ...]
153 |                    dst_datasource_name src_datasource_name
154 |                    [-lco NAME=VALUE] [-nln name]
155 |                    [-nlt type|PROMOTE_TO_MULTI|CONVERT_TO_LINEAR|CONVERT_TO_CURVE]
156 |                    [-dim XY|XYZ|XYM|XYZM|2|3|layer_dim] [layer [layer ...]]
157 | 
158 |     Advanced options :
159 |                    [-gt n]
160 |                    [[-oo NAME=VALUE] ...] [[-doo NAME=VALUE] ...]
161 |                    [-clipsrc [xmin ymin xmax ymax]|WKT|datasource|spat_extent]
162 |                    [-clipsrcsql sql_statement] [-clipsrclayer layer]
163 |                    [-clipsrcwhere expression]
164 |                    [-clipdst [xmin ymin xmax ymax]|WKT|datasource]
165 |                    [-clipdstsql sql_statement] [-clipdstlayer layer]
166 |                    [-clipdstwhere expression]
167 |                    [-wrapdateline] [-datelineoffset val]
168 |                    [[-simplify tolerance] | [-segmentize max_dist]]
169 |                    [-addfields] [-unsetFid]
170 |                    [-relaxedFieldNameMatch] [-forceNullable] [-unsetDefault]
171 |                    [-fieldTypeToString All|(type1[,type2]*)] [-unsetFieldWidth]
172 |                    [-mapFieldType type1|All=type2[,type3=type4]*]
173 |                    [-fieldmap identity | index1[,index2]*]
174 |                    [-splitlistfields] [-maxsubfields val]
175 |                    [-explodecollections] [-zfield field_name]
176 |                    [-gcp pixel line easting northing [elevation]]* [-order n | -tps]
177 |                    [-nomd] [-mo "META-TAG=VALUE"]* [-noNativeData]
178 | 
179 | .. program:: ogr2ogr
180 | 
181 | .. cmdoption:: -f format_name:
182 | 
183 |     默认为 ``-f "ESRI Shapefile"`` ,设置输出格式
184 |     
185 | .. cmdoption:: -append:
186 | 
187 |     添加到已存在的图层中,而非新建图层
188 |     
189 | .. cmdoption:: -update:
190 | 
191 |     更新已存在的数据集
192 |     
193 | .. cmdoption:: -select field_list:
194 | 
195 |     将字段复制到新图层中,使用逗号隔开字段名,默认全部复制, GDAL1.11开始可以复制geometry字段
196 |     
197 | .. cmdoption:: -progress:
198 |     
199 |     显示进度条,仅当输入图层有"fast feature count"属性
200 | 
201 | .. cmdoption:: -sql sql_statement:
202 | 
203 |     执行SQL语句,结果将输出到文件中.GDAL2.1以后,可以使用 ``@filename`` 语法指定针对文件查询.
204 |     
205 | .. cmdoption:: -dialect dialect:
206 | 
207 |     特定SQL语法类型 OGRSQL 或 SQLITE .
208 |     
209 | .. cmdoption:: -where restricted_where:
210 | 
211 |     属性查询 (like SQL WHERE). GDAL2.1以后,可以使用 ``@filename`` 语法指定针对文件查询.
212 |     
213 | .. cmdoption:: -skipfailures:
214 | 
215 |     跳过错误继续执行
216 |     
217 | .. cmdoption:: -spat xmin ymin xmax ymax:
218 | 
219 |     空间范围指定,空间范围外的要素将被剔除,范围内几何要素默认不被裁剪,除非设置 ``-clipsrc``
220 |     
221 | .. cmdoption:: -spat_srs srs_def:
222 | 
223 |     (OGR >= 2.0) 覆盖空间过滤查询的 SRS.
224 |     
225 | .. cmdoption:: -geomfield field:
226 | 
227 |     (OGR >= 1.11) 空间过滤条件的geometry 字段名.
228 |     
229 | .. cmdoption:: -dsco NAME=VALUE:
230 | 
231 |     数据集创建选项 (format specific)
232 | 
233 | .. cmdoption:: -lco NAME=VALUE:
234 | 
235 |     图层创建选项(format specific)
236 | 
237 | .. cmdoption:: -nln name:
238 | 
239 |     指定创建图层的名称
240 | 
241 | .. cmdoption:: -nlt type:
242 | 
243 |     指定创建图层的几何类型 NONE, GEOMETRY, POINT, LINESTRING, POLYGON, GEOMETRYCOLLECTION, MULTIPOINT, MULTIPOLYGON or MULTILINESTRING. And CIRCULARSTRING, COMPOUNDCURVE, CURVEPOLYGON, MULTICURVE and MULTISURFACE ( GDAL 2.0). 在类型后添加 "Z", "M", 或 "ZM" 可以设置高程/测量信息.GDAL 1.10后, PROMOTE_TO_MULTI 可以自动将polygon multipolygons混合图层转为multipolygons图层,linestrings 和 multilinestrings混合图层转为multilinestrings图层.GDAL 2.0 后, 可以使用CONVERT_TO_LINEAR将其他图层转为线层, 使用 CONVERT_TO_CURVE 将非线性图层转为广义曲线类型(POLYGON to CURVEPOLYGON, MULTIPOLYGON to MULTISURFACE, LINESTRING to COMPOUNDCURVE, MULTILINESTRING to MULTICURVE).  2.1 后类型可以添加25D,与Z相同
244 |     
245 | .. cmdoption:: -dim val:
246 | 
247 |     (>GDAL 1.10) 强制坐标维数 ( XY, XYZ, XYM,  XYZM -). 
248 |     
249 | .. cmdoption:: -a_srs srs_def:
250 | 
251 |     设置输出 SRS
252 | 
253 | .. cmdoption:: -t_srs srs_def:
254 | 
255 |     重投影/变换到此 SRS
256 |     
257 | .. cmdoption:: -s_srs srs_def:
258 | 
259 |     重指定输入 SRS
260 | 
261 | .. cmdoption:: -preserve_fid:
262 |     
263 |     指定与源数据相同的FID,而非默认生成FID. GDAL 2.0 以后此为默认选项,可以使用 -unsetFid 禁止此行为.
264 | 
265 | .. cmdoption:: -fid fid:
266 | 
267 |     处理指定fid要素,与 '-where "fid in (1,3,5)"' 效果类似.
268 | 
269 | 高级选项 :
270 | 
271 | .. cmdoption:: -oo NAME=VALUE:
272 | 
273 |     (>= GDAL 2.0) 输入数据集打开选项(format specific)
274 | 
275 | .. cmdoption:: -doo NAME=VALUE:
276 | 
277 |     (>=GDAL 2.0) 输出数据集打开选项, (format specific), 仅在 -update 模式中使用
278 |     
279 | .. cmdoption:: -gt n:
280 | 
281 |     每次提交事务中多少要素进行转换(OGR 1.11 默认20000  , 之前版本为200),越大越快. GDAL 2.0之后可以使用unlimited一次事务中全部处理.
282 |     
283 | .. cmdoption:: -ds_transaction:
284 | 
285 |     (>=GDAL 2.0) 强制使用事务
286 | 
287 | .. cmdoption:: -clipsrc [xmin ymin xmax ymax]|WKT|datasource|spat_extent:
288 | 
289 |     (>=GDAL 1.7.0) 使用包络框裁切几何要素,如果指定datasource,还需使用 -clipsrcsql -clipsrclayer  -clipsrcwhere 指定裁切要素
290 | 
291 | .. cmdoption:: -clipsrcsql sql_statement:
292 | 
293 |     使用sql查询选择所需裁切几何要素
294 | 
295 | .. cmdoption:: -clipsrclayer layername:
296 | 
297 |     选择裁切图层
298 |     
299 | .. cmdoption:: -clipsrcwhere expression:
300 | 
301 |     使用属性查询重新限定裁切要素
302 | 
303 | .. cmdoption:: -clipdst [xmin ymin xmax ymax]|WKT|datasource|spat_extent:
304 | 
305 |     (>=GDAL 1.7.0) 重投影后将要素裁切到指定范围内,如果指定数据源,还需使用-clipdstlayer, -clipdstwhere  -clipdstsql指定带裁切的数据
306 | 
307 | .. cmdoption:: -clipdstsql sql_statement:
308 | 
309 |     使用sql查询选择所需待裁切几何要素
310 | 
311 | .. cmdoption:: -clipdstlayer layername:
312 | 
313 |     选择待裁切图层
314 | 
315 | .. cmdoption:: -clipdstwhere expression:
316 | 
317 |     使用属性查询重新限定待裁切要素
318 | 
319 | .. cmdoption:: -wrapdateline:
320 | 
321 |     (starting with GDAL 1.7.0) 分割穿过经线的几何要素 (long. = +/- 180deg)
322 | 
323 | .. cmdoption:: -datelineoffset:
324 | 
325 |     (starting with GDAL 1.10) 偏移分割经线 (default long. = +/- 10deg, geometries within 170deg to -170deg will be split)
326 | 
327 | .. cmdoption:: -simplify tolerance:
328 | 
329 |     (starting with GDAL 1.9.0) 化简图形,化简是保持每个图形的拓扑,不保证整个层的拓扑.
330 | 
331 | .. cmdoption:: -segmentize max_dist:
332 | 
333 |     (starting with GDAL 1.6.0) 两节点间最大距离.用于创建分割节点
334 | 
335 | .. cmdoption:: -fieldTypeToString type1,...:
336 | 
337 |     (starting with GDAL 1.7.0)将指定字段类型转为String类型到输出图层中,可以指定类型为: Integer, Integer64, Real, String, Date, Time, DateTime, Binary, IntegerList, Integer64List, RealList, StringList. 
338 | 
339 | .. cmdoption:: -mapFieldType srctype|All=dsttype,...:
340 | 
341 |     (starting with GDAL 2.0) 将指定字段类型转换为其他类型,可指定类型为: Integer, Integer64, Real, String, Date, Time, DateTime, Binary, IntegerList, Integer64List, RealList, StringList.可以使用括号指定同时被转换的子类型, 例如:Integer(Boolean), Real(Float32)
342 | 
343 | .. cmdoption:: -unsetFieldWidth:
344 | 
345 |     (starting with GDAL 1.11)重置字段宽度和精度为0.
346 | 
347 | .. cmdoption:: -splitlistfields:
348 | 
349 |     (starting with GDAL 1.8.0) 将列表字段分割为多个字段,例如 StringList, RealList ,IntegerList转为多个 String, Real or Integer.
350 | 
351 | .. cmdoption:: -maxsubfields val:
352 | 
353 |    与 -splitlistfields 结合使用,限制分割个数
354 | 
355 | .. cmdoption:: -explodecollections:
356 | 
357 |     (starting with GDAL 1.8.0) 为每个geometry生成一个feature
358 | 
359 | .. cmdoption:: -zfield field_name:
360 | 
361 |     (starting with GDAL 1.8.0)用指定字段填充Z值
362 | 
363 | .. cmdoption:: -gcp ungeoref_x ungeoref_y georef_x georef_y elevation:
364 | 
365 |     (starting with GDAL 1.10.0)指定地面控制点 ,可添加多个.
366 | 
367 | .. cmdoption:: -order n:
368 | 
369 |     (starting with GDAL 1.10.0)指定转换时多项式次数,默认根据控制点选择多项式阶数.
370 | 
371 | .. cmdoption:: -tps:
372 | 
373 |     (starting with GDAL 1.10.0) 强制使用tps转换
374 | 
375 | .. cmdoption:: -fieldmap:
376 | 
377 |     (starting with GDAL 1.10.0)与 -append一起使用,指定需要从源图层复制的字段索引列表,索引从0开始计算
378 | 
379 | .. cmdoption:: -addfields:
380 | 
381 |     (starting with GDAL 1.11)这是特定的-append版本.只能添加字段到指定输出图层中,一般用于合并字段不完全相同的文件
382 | 
383 | .. cmdoption:: -relaxedFieldNameMatch:
384 | 
385 |     (starting with GDAL 1.11) 放宽字段名称匹配条件 [-relaxedFieldNameMatch] [-forceNullable]
386 | 
387 | .. cmdoption:: -forceNullable:
388 | 
389 |     (starting with GDAL 2.0)去掉源图层禁止非空值的约束
390 | 
391 | .. cmdoption:: -unsetDefault:
392 | 
393 |     (starting with GDAL 2.0)去掉源图层的默认值
394 | 
395 | .. cmdoption:: -unsetFid:
396 | 
397 |     (starting with GDAL 2.0) 重置所有fid
398 | 
399 | .. cmdoption:: -nomd:
400 | 
401 |     (starting with GDAL 2.0) 禁止拷贝源图层的元数据
402 | 
403 | .. cmdoption:: -mo "META-TAG=VALUE":
404 | 
405 |     (starting with GDAL 2.0)指定元数据 
406 | 
407 | .. cmdoption:: -noNativeData:
408 | 
409 |     (starting with GDAL 2.1) To disable copying of native data, i.e. details of source format not captured by OGR abstraction, that are otherwise preserved by some drivers (like GeoJSON) when converting to same format.


--------------------------------------------------------------------------------
/conf.py:
--------------------------------------------------------------------------------
  1 | # -*- coding: utf-8 -*-
  2 | #
  3 | # headfirst gdal documentation build configuration file, created by
  4 | # sphinx-quickstart on Sat Oct 12 10:16:09 2013.
  5 | #
  6 | # This file is execfile()d with the current directory set to its
  7 | # containing dir.
  8 | #
  9 | # Note that not all possible configuration values are present in this
 10 | # autogenerated file.
 11 | #
 12 | # All configuration values have a default; values that are commented out
 13 | # serve to show the default.
 14 | 
 15 | import sys
 16 | import os
 17 | 
 18 | # If extensions (or modules to document with autodoc) are in another directory,
 19 | # add these directories to sys.path here. If the directory is relative to the
 20 | # documentation root, use os.path.abspath to make it absolute, like shown here.
 21 | #sys.path.insert(0, os.path.abspath('.'))
 22 | 
 23 | # -- General configuration ------------------------------------------------
 24 | 
 25 | # If your documentation needs a minimal Sphinx version, state it here.
 26 | #needs_sphinx = '1.0'
 27 | 
 28 | # Add any Sphinx extension module names here, as strings. They can be
 29 | # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 30 | # ones.
 31 | extensions = [
 32 |     'sphinx.ext.autodoc',
 33 |     'sphinx.ext.doctest',
 34 |     'sphinx.ext.intersphinx',
 35 | ]
 36 | 
 37 | # Add any paths that contain templates here, relative to this directory.
 38 | templates_path = ['_templates']
 39 | 
 40 | # The suffix of source filenames.
 41 | source_suffix = '.rst'
 42 | 
 43 | # The encoding of source files.
 44 | #source_encoding = 'utf-8-sig'
 45 | 
 46 | # The master toctree document.
 47 | master_doc = 'index'
 48 | 
 49 | # General information about the project.
 50 | project = u'headfirst gdal'
 51 | copyright = u'2013-2018, wuqi'
 52 | 
 53 | # The version info for the project you're documenting, acts as replacement for
 54 | # |version| and |release|, also used in various other places throughout the
 55 | # built documents.
 56 | #
 57 | # The short X.Y version.
 58 | version = '0.1'
 59 | # The full version, including alpha/beta/rc tags.
 60 | release = '0.1'
 61 | 
 62 | # The language for content autogenerated by Sphinx. Refer to documentation
 63 | # for a list of supported languages.
 64 | #language = 'en'
 65 | 
 66 | # There are two options for replacing |today|: either, you set today to some
 67 | # non-false value, then it is used:
 68 | #today = ''
 69 | # Else, today_fmt is used as the format for a strftime call.
 70 | #today_fmt = '%B %d, %Y'
 71 | 
 72 | # List of patterns, relative to source directory, that match files and
 73 | # directories to ignore when looking for source files.
 74 | exclude_patterns = ['_build','theme']
 75 | 
 76 | # The reST default role (used for this markup: `text`) to use for all
 77 | # documents.
 78 | #default_role = None
 79 | 
 80 | # If true, '()' will be appended to :func: etc. cross-reference text.
 81 | #add_function_parentheses = True
 82 | 
 83 | # If true, the current module name will be prepended to all description
 84 | # unit titles (such as .. function::).
 85 | #add_module_names = True
 86 | 
 87 | # If true, sectionauthor and moduleauthor directives will be shown in the
 88 | # output. They are ignored by default.
 89 | #show_authors = False
 90 | 
 91 | # The name of the Pygments (syntax highlighting) style to use.['monokai', 'manni', 'rrt', 'perldoc', 'borland', 'colorful', 'default', 'murphy', 'vs', 'trac', 'tango', 'fruity', 'autumn', 'bw', 'emacs', 'vim', 'pastie', 'friendly', 'native']
 92 | #best  perldoc  borland colorful  pastie    vs
 93 | pygments_style = 'emacs'
 94 | 
 95 | # A list of ignored prefixes for module index sorting.
 96 | #modindex_common_prefix = []
 97 | 
 98 | # If true, keep warnings as "system message" paragraphs in the built documents.
 99 | #keep_warnings = False
100 | 
101 | 
102 | # -- Options for HTML output ----------------------------------------------
103 | 
104 | # The theme to use for HTML and HTML Help pages.  See the documentation for
105 | # a list of builtin themes. nature  sphinxdoc  default  pyramid traditional scrolls agogo  haiku sphinx_rtd_theme solar
106 | html_theme = 'sphinx_rtd_theme'
107 | 
108 | # Theme options are theme-specific and customize the look and feel of a theme
109 | # further.  For a list of options available for each theme, see the
110 | # documentation.
111 | #html_theme_options = {}
112 | 
113 | # Add any paths that contain custom themes here, relative to this directory.
114 | html_theme_path = ['theme']
115 | 
116 | # The name for this set of Sphinx documents.  If None, it defaults to
117 | # "<project> v<release> documentation".
118 | #html_title = None
119 | 
120 | # A shorter title for the navigation bar.  Default is the same as html_title.
121 | #html_short_title = None
122 | 
123 | # The name of an image file (relative to this directory) to place at the top
124 | # of the sidebar.
125 | #html_logo = None
126 | 
127 | # The name of an image file (within the static path) to use as favicon of the
128 | # docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
129 | # pixels large.
130 | #html_favicon = None
131 | 
132 | # Add any paths that contain custom static files (such as style sheets) here,
133 | # relative to this directory. They are copied after the builtin static files,
134 | # so a file named "default.css" will overwrite the builtin "default.css".
135 | #html_static_path = ['_static']
136 | 
137 | # Add any extra paths that contain custom files (such as robots.txt or
138 | # .htaccess) here, relative to this directory. These files are copied
139 | # directly to the root of the documentation.
140 | #html_extra_path = []
141 | 
142 | # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
143 | # using the given strftime format.
144 | #html_last_updated_fmt = '%b %d, %Y'
145 | 
146 | # If true, SmartyPants will be used to convert quotes and dashes to
147 | # typographically correct entities.
148 | #html_use_smartypants = True
149 | 
150 | # Custom sidebar templates, maps document names to template names.
151 | #html_sidebars = {}
152 | 
153 | # Additional templates that should be rendered to pages, maps page names to
154 | # template names.
155 | #html_additional_pages = {}
156 | 
157 | # If false, no module index is generated.
158 | #html_domain_indices = True
159 | 
160 | # If false, no index is generated.
161 | #html_use_index = True
162 | 
163 | # If true, the index is split into individual pages for each letter.
164 | #html_split_index = False
165 | 
166 | # If true, links to the reST sources are added to the pages.
167 | #html_show_sourcelink = True
168 | 
169 | # If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
170 | #html_show_sphinx = True
171 | 
172 | # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
173 | #html_show_copyright = True
174 | 
175 | # If true, an OpenSearch description file will be output, and all pages will
176 | # contain a <link> tag referring to it.  The value of this option must be the
177 | # base URL from which the finished HTML is served.
178 | #html_use_opensearch = ''
179 | 
180 | # This is the file name suffix for HTML files (e.g. ".xhtml").
181 | #html_file_suffix = None
182 | 
183 | # Output file base name for HTML help builder.
184 | htmlhelp_basename = 'headfirstgdaldoc'
185 | 
186 | 
187 | # -- Options for LaTeX output ---------------------------------------------
188 | 
189 | latex_elements = {
190 | 'pointsize': '10pt',
191 | 'classoptions': ',oneside',
192 |  'babel': '\\usepackage[english]{babel}',
193 | 'preamble': '''
194 | \setcounter{tocdepth}{3}
195 | \\hypersetup{unicode=true}
196 | \\usepackage{CJKutf8}
197 | \\AtBeginDocument{\\begin{CJK}{UTF8}{gbsn}}
198 | \\AtEndDocument{\\end{CJK}}
199 | '''
200 | # The paper size ('letterpaper' or 'a4paper').
201 | #'papersize': 'letterpaper',
202 | 
203 | # The font size ('10pt', '11pt' or '12pt').
204 | #'pointsize': '10pt',
205 | 
206 | # Additional stuff for the LaTeX preamble.
207 | #'preamble': '',
208 | }
209 | 
210 | # Grouping the document tree into LaTeX files. List of tuples
211 | # (source start file, target name, title,
212 | #  author, documentclass [howto, manual, or own class]).
213 | latex_documents = [
214 |   ('index', 'headfirstgdal.tex', u'Headfirst GDAL Documentation',
215 |    u'Wu Qi', 'manual'),
216 | ]
217 | 
218 | # The name of an image file (relative to this directory) to place at the top of
219 | # the title page.
220 | #latex_logo = None
221 | 
222 | # For "manual" documents, if this is true, then toplevel headings are parts,
223 | # not chapters.
224 | #latex_use_parts = False
225 | 
226 | # If true, show page references after internal links.
227 | #latex_show_pagerefs = False
228 | 
229 | # If true, show URL addresses after external links.
230 | #latex_show_urls = False
231 | 
232 | # Documents to append as an appendix to all manuals.
233 | #latex_appendices = []
234 | 
235 | # If false, no module index is generated.
236 | #latex_domain_indices = True
237 | 
238 | 
239 | # -- Options for manual page output ---------------------------------------
240 | 
241 | # One entry per manual page. List of tuples
242 | # (source start file, name, description, authors, manual section).
243 | man_pages = [
244 |     ('index', 'headfirstgdal', u'headfirst gdal Documentation',
245 |      [u'wuqi'], 1)
246 | ]
247 | 
248 | # If true, show URL addresses after external links.
249 | #man_show_urls = False
250 | 
251 | 
252 | # -- Options for Texinfo output -------------------------------------------
253 | 
254 | # Grouping the document tree into Texinfo files. List of tuples
255 | # (source start file, target name, title, author,
256 | #  dir menu entry, description, category)
257 | texinfo_documents = [
258 |   ('index', 'headfirstgdal', u'headfirst gdal Documentation',
259 |    u'wuqi', 'headfirstgdal', 'One line description of project.',
260 |    'Miscellaneous'),
261 | ]
262 | 
263 | # Documents to append as an appendix to all manuals.
264 | #texinfo_appendices = []
265 | 
266 | # If false, no module index is generated.
267 | #texinfo_domain_indices = True
268 | 
269 | # How to display URL addresses: 'footnote', 'no', or 'inline'.
270 | #texinfo_show_urls = 'footnote'
271 | 
272 | # If true, do not generate a @detailmenu in the "Top" node's menu.
273 | #texinfo_no_detailmenu = False
274 | 
275 | 
276 | # -- Options for Epub output ----------------------------------------------
277 | 
278 | # Bibliographic Dublin Core info.
279 | epub_title = u'headfirst gdal'
280 | epub_author = u'wuqi'
281 | epub_publisher = u'wuqi'
282 | epub_copyright = u'2013, wuqi'
283 | 
284 | # The basename for the epub file. It defaults to the project name.
285 | #epub_basename = u'headfirst gdal'
286 | 
287 | # The HTML theme for the epub output. Since the default themes are not optimized
288 | # for small screen space, using the same theme for HTML and epub output is
289 | # usually not wise. This defaults to 'epub', a theme designed to save visual
290 | # space.
291 | #epub_theme = 'epub'
292 | 
293 | # The language of the text. It defaults to the language option
294 | # or en if the language is not set.
295 | #epub_language = ''
296 | 
297 | # The scheme of the identifier. Typical schemes are ISBN or URL.
298 | #epub_scheme = ''
299 | 
300 | # The unique identifier of the text. This can be a ISBN number
301 | # or the project homepage.
302 | #epub_identifier = ''
303 | 
304 | # A unique identification for the text.
305 | #epub_uid = ''
306 | 
307 | # A tuple containing the cover image and cover page html template filenames.
308 | #epub_cover = ()
309 | 
310 | # A sequence of (type, uri, title) tuples for the guide element of content.opf.
311 | #epub_guide = ()
312 | 
313 | # HTML files that should be inserted before the pages created by sphinx.
314 | # The format is a list of tuples containing the path and title.
315 | #epub_pre_files = []
316 | 
317 | # HTML files shat should be inserted after the pages created by sphinx.
318 | # The format is a list of tuples containing the path and title.
319 | #epub_post_files = []
320 | 
321 | # A list of files that should not be packed into the epub file.
322 | #epub_exclude_files = []
323 | 
324 | # The depth of the table of contents in toc.ncx.
325 | #epub_tocdepth = 3
326 | 
327 | # Allow duplicate toc entries.
328 | #epub_tocdup = True
329 | 
330 | # Choose between 'default' and 'includehidden'.
331 | #epub_tocscope = 'default'
332 | 
333 | # Fix unsupported image types using the PIL.
334 | #epub_fix_images = False
335 | 
336 | # Scale large images.
337 | #epub_max_image_width = 0
338 | 
339 | # How to display URL addresses: 'footnote', 'no', or 'inline'.
340 | #epub_show_urls = 'inline'
341 | 
342 | # If false, no index is generated.
343 | #epub_use_index = True
344 | 
345 | 
346 | # Example configuration for intersphinx: refer to the Python standard library.
347 | intersphinx_mapping = {'http://docs.python.org/': None}
348 | 


--------------------------------------------------------------------------------
/ogr-read-write.rst:
--------------------------------------------------------------------------------
  1 | .. highlight:: rst
  2 | 
  3 | .. _ogrreadwrite:
  4 | 
  5 | ################
  6 | 矢量数据读写
  7 | ################
  8 | 
  9 | .. _ogrread:
 10 | 
 11 | ******************
 12 | 数据读取
 13 | ******************
 14 | 与栅格的 :ref:`gdalread` 流程类似，但矢量数据定位明显，属性隐含，其几何形状和属性需要分开读取，GDAL有两个版本，读取接口不同，但是流程基本相同，以下是获取流程：
 15 | 
 16 | * 注册驱动
 17 | * 打开数据集
 18 | * 打开图层
 19 | * 获取要素类定义
 20 | * 遍历要素
 21 | * 获取几何形状以及属性信息
 22 | 
 23 | ``1.x`` 版本完整代码示例：
 24 | 
 25 | .. code-block:: c++
 26 | 
 27 |     #include "ogrsf_frmts.h"
 28 |     int main()
 29 |     {
 30 |         //注册驱动
 31 |         OGRRegisterAll();
 32 |         //打开数据集
 33 |         OGRDataSource       *poDS;
 34 |         poDS = OGRSFDriverRegistrar::Open( "point.shp", FALSE );
 35 |         if( poDS == NULL )
 36 |         {
 37 |             printf( "Open failed.\n" );
 38 |             exit( 1 );
 39 |         }
 40 |         //打开图层
 41 |         OGRLayer  *poLayer;
 42 |         poLayer = poDS->GetLayerByName( "point" );
 43 |         OGRFeature *poFeature;
 44 |         //遍历要素
 45 |         poLayer->ResetReading();
 46 |         while( (poFeature = poLayer->GetNextFeature()) != NULL )
 47 |         {
 48 |             //获取要素类定义
 49 |             OGRFeatureDefn *poFDefn = poLayer->GetLayerDefn();
 50 |             int iField;
 51 |             //获取属性信息
 52 |             for( iField = 0; iField < poFDefn->GetFieldCount(); iField++ )
 53 |             {
 54 |                 OGRFieldDefn *poFieldDefn = poFDefn->GetFieldDefn( iField );
 55 |                 if( poFieldDefn->GetType() == OFTInteger )
 56 |                     printf( "%d,", poFeature->GetFieldAsInteger( iField ) );
 57 |                 else if( poFieldDefn->GetType() == OFTReal )
 58 |                     printf( "%.3f,", poFeature->GetFieldAsDouble(iField) );
 59 |                 else if( poFieldDefn->GetType() == OFTString )
 60 |                     printf( "%s,", poFeature->GetFieldAsString(iField) );
 61 |                 else
 62 |                     printf( "%s,", poFeature->GetFieldAsString(iField) );
 63 |             }
 64 |             //获取几何形状
 65 |             OGRGeometry *poGeometry;
 66 |             poGeometry = poFeature->GetGeometryRef();
 67 |             if( poGeometry != NULL 
 68 |                 && wkbFlatten(poGeometry->getGeometryType()) == wkbPoint )
 69 |             {
 70 |                 OGRPoint *poPoint = (OGRPoint *) poGeometry;
 71 |                 printf( "%.3f,%3.f\n", poPoint->getX(), poPoint->getY() );
 72 |             }
 73 |             else
 74 |             {
 75 |                 printf( "no point geometry\n" );
 76 |             }       
 77 |             OGRFeature::DestroyFeature( poFeature );
 78 |         }
 79 |         OGRDataSource::DestroyDataSource( poDS );
 80 |     }
 81 | 
 82 | 2.x 版本中最主要修改为 ``GDALDataset`` 代替``OGRDataSource`` 其余接口大致不变.打开方式略有区别
 83 | 
 84 | .. code-block:: c++
 85 | 
 86 |     /**
 87 |     * @param pszFilename 文件名
 88 |     * @param nOpenFlags  GDAL_OF_RASTER/GDAL_OF_VECTOR  数据类型
 89 |                          GDAL_OF_READONLY/GDAL_OF_UPDATE 打开方式
 90 |                          GDAL_OF_SHARED 共享模式
 91 |                          GDAL_OF_VERBOSE_ERROR 返回详细错误
 92 |     * @param papszAllowedDrivers NULL或以NULL结尾的列表,指定驱动
 93 |     * @param papszOpenOptions NULL或以NULL结尾的字符串列表,根据驱动设置
 94 |     * @param papszSiblingFiles NULL或以NULL结尾的文件列表
 95 |     */
 96 |     GDALDatasetH GDALOpenEx	(	const char * 	pszFilename,
 97 |     unsigned int 	nOpenFlags,
 98 |     const char *const * 	papszAllowedDrivers,
 99 |     const char *const * 	papszOpenOptions,
100 |     const char *const * 	papszSiblingFiles 
101 |     )	
102 | 
103 | 
104 | .. attention::
105 | 
106 |     * 打开前建议添加 ``CPLSetConfigOption("GDAL_FILENAME_IS_UTF8", "NO");`` 设置,保证windows下文件名中文路径正常打开
107 |     * 打开前添加 ``CPLSetConfigOption("SHAPE_ENCODING", "");`` 读出来编码和系统编码保持一致
108 | 
109 | 
110 | 2.x 版本完整代码示例： 
111 | 
112 | .. code-block:: c++
113 | 
114 |     #include "ogrsf_frmts.h"
115 |     int main()
116 |     {
117 |         CPLSetConfigOption("GDAL_FILENAME_IS_UTF8", "NO");
118 |         CPLSetConfigOption("SHAPE_ENCODING", "");
119 |         //主要修改
120 |         GDALAllRegister();
121 |         GDALDataset       *poDS;
122 |         poDS = (GDALDataset*) GDALOpenEx( "point.shp", GDAL_OF_VECTOR, NULL, NULL, NULL );
123 |         if( poDS == NULL )
124 |         {
125 |             printf( "Open failed.\n" );
126 |             exit( 1 );
127 |         }
128 | 
129 |         //后面与1.x版本一致
130 |         OGRLayer  *poLayer;
131 |         poLayer = poDS->GetLayerByName( "point" );
132 |         //寻找特定字段
133 |         OGRFeatureDefn *poFDefn = poLayer->GetLayerDefn();
134 | 
135 |         int nSIDIndex = poFDefn->GetFieldIndex("SS_ID");
136 |         if (nSIDIndex < 0)
137 |         {
138 |             printf( "can't find SS_ID field.\n" );
139 |         }
140 | 
141 |         OGRFeature *poFeature;
142 |         poLayer->ResetReading();
143 |         while( (poFeature = poLayer->GetNextFeature()) != NULL )
144 |         {
145 |             //获取固定字段值
146 |             if(nSIDIndex >= 0)
147 |             {
148 |                 std::string strSSID = poFeature->GetFieldAsString(nSIDIndex);
149 |             }
150 |             OGRFeatureDefn *poFDefn = poLayer->GetLayerDefn();
151 |             int iField;
152 |             for( iField = 0; iField < poFDefn->GetFieldCount(); iField++ )
153 |             {
154 |                 OGRFieldDefn *poFieldDefn = poFDefn->GetFieldDefn( iField );
155 |                 if( poFieldDefn->GetType() == OFTInteger )
156 |                     printf( "%d,", poFeature->GetFieldAsInteger( iField ) );
157 |                 else if( poFieldDefn->GetType() == OFTInteger64 )
158 |                     printf( CPL_FRMT_GIB ",", poFeature->GetFieldAsInteger64( iField ) );
159 |                 else if( poFieldDefn->GetType() == OFTReal )
160 |                     printf( "%.3f,", poFeature->GetFieldAsDouble(iField) );
161 |                 else if( poFieldDefn->GetType() == OFTString )
162 |                     printf( "%s,", poFeature->GetFieldAsString(iField) );
163 |                 else
164 |                     printf( "%s,", poFeature->GetFieldAsString(iField) );
165 |             }
166 |             OGRGeometry *poGeometry;
167 |             poGeometry = poFeature->GetGeometryRef();
168 |             if( poGeometry != NULL 
169 |                     && wkbFlatten(poGeometry->getGeometryType()) == wkbPoint )
170 |             {
171 |                 OGRPoint *poPoint = (OGRPoint *) poGeometry;
172 |                 printf( "%.3f,%3.f\n", poPoint->getX(), poPoint->getY() );
173 |             }
174 |             else
175 |             {
176 |                 printf( "no point geometry\n" );
177 |             }
178 |             OGRFeature::DestroyFeature( poFeature );
179 |         }
180 |         GDALClose( poDS );
181 |     }
182 | 
183 | 
184 | .. attention::
185 | 
186 |     * 有很多矢量驱动是只读的，无法像栅格那样直接修改和创建文件。
187 |     * 如果需要确定，可以使用 ``ogrinfo --formats`` 确定驱动的权限。
188 | 
189 | 
190 | .. _ogrwrite:
191 | 
192 | ******************
193 | 数据写入
194 | ******************
195 | 数据写入与读取类似，流程如下：
196 | 
197 | * 注册驱动
198 | * 打开或创建数据集
199 | * 创建图层
200 | * 创建要素类定义
201 | * 新建几何形状
202 | * 新建要素
203 | * 关闭数据集
204 | 
205 | 1.x完整代码示例（ ``C++``）：
206 | 
207 | .. code-block:: c++
208 | 
209 |     #include "ogrsf_frmts.h"
210 |     int main()
211 |     {
212 |         const char *pszDriverName = "ESRI Shapefile";
213 |         OGRSFDriver *poDriver;
214 |         OGRRegisterAll();
215 |         poDriver = OGRSFDriverRegistrar::GetRegistrar()->GetDriverByName(
216 |                     pszDriverName );
217 |         if( poDriver == NULL )
218 |         {
219 |             printf( "%s driver not available.\n", pszDriverName );
220 |             exit( 1 );
221 |         }
222 |         OGRDataSource *poDS;
223 |         poDS = poDriver->CreateDataSource( "point_out.shp", NULL );
224 |         if( poDS == NULL )
225 |         {
226 |             printf( "Creation of output file failed.\n" );
227 |             exit( 1 );
228 |         }
229 |         OGRLayer *poLayer;
230 |         poLayer = poDS->CreateLayer( "point_out", NULL, wkbPoint, NULL );
231 |         if( poLayer == NULL )
232 |         {
233 |             printf( "Layer creation failed.\n" );
234 |             exit( 1 );
235 |         }
236 |         OGRFieldDefn oField( "Name", OFTString );
237 |         oField.SetWidth(32);
238 |         if( poLayer->CreateField( &oField ) != OGRERR_NONE )
239 |         {
240 |             printf( "Creating Name field failed.\n" );
241 |             exit( 1 );
242 |         }
243 |         double x, y;
244 |         char szName[33];
245 |         while( !feof(stdin) 
246 |                && fscanf( stdin, "%lf,%lf,%32s", &x, &y, szName ) == 3 )
247 |         {
248 |             OGRFeature *poFeature;
249 |             poFeature = OGRFeature::CreateFeature( poLayer->GetLayerDefn() );
250 |             poFeature->SetField( "Name", szName );
251 |             OGRPoint pt;
252 |             
253 |             pt.setX( x );
254 |             pt.setY( y );
255 |      
256 |             poFeature->SetGeometry( &pt ); 
257 |             if( poLayer->CreateFeature( poFeature ) != OGRERR_NONE )
258 |             {
259 |                printf( "Failed to create feature in shapefile.\n" );
260 |                exit( 1 );
261 |             }
262 |              OGRFeature::DestroyFeature( poFeature );
263 |         }
264 |         OGRDataSource::DestroyDataSource( poDS );
265 |     }
266 |     
267 | 
268 | 2.x 完整代码示例（ ``C++``）：
269 | 
270 | .. code-block:: c++
271 | 
272 |     #include "ogrsf_frmts.h"
273 |     int main()
274 |     {
275 |         const char *pszDriverName = "ESRI Shapefile";
276 |         GDALDriver *poDriver;
277 |         GDALAllRegister();
278 |         poDriver = GetGDALDriverManager()->GetDriverByName(pszDriverName );
279 |         if( poDriver == NULL )
280 |         {
281 |             printf( "%s driver not available.\n", pszDriverName );
282 |             exit( 1 );
283 |         }
284 |         GDALDataset *poDS;
285 |         poDS = poDriver->Create( "point_out.shp", 0, 0, 0, GDT_Unknown, NULL );
286 |         if( poDS == NULL )
287 |         {
288 |             printf( "Creation of output file failed.\n" );
289 |             exit( 1 );
290 |         }
291 |         OGRLayer *poLayer;
292 |         poLayer = poDS->CreateLayer( "point_out", NULL, wkbPoint, NULL );
293 |         if( poLayer == NULL )
294 |         {
295 |             printf( "Layer creation failed.\n" );
296 |             exit( 1 );
297 |         }
298 |         OGRFieldDefn oField( "Name", OFTString );
299 |         oField.SetWidth(32);
300 |         if( poLayer->CreateField( &oField ) != OGRERR_NONE )
301 |         {
302 |             printf( "Creating Name field failed.\n" );
303 |             exit( 1 );
304 |         }
305 |         double x, y;
306 |         char szName[33];
307 |         while( !feof(stdin) 
308 |                && fscanf( stdin, "%lf,%lf,%32s", &x, &y, szName ) == 3 )
309 |         {
310 |             OGRFeature *poFeature;
311 |             poFeature = OGRFeature::CreateFeature( poLayer->GetLayerDefn() );
312 |             poFeature->SetField( "Name", szName );
313 |             OGRPoint pt;
314 |             
315 |             pt.setX( x );
316 |             pt.setY( y );
317 |         
318 |             poFeature->SetGeometry( &pt ); 
319 |             if( poLayer->CreateFeature( poFeature ) != OGRERR_NONE )
320 |             {
321 |                 printf( "Failed to create feature in shapefile.\n" );
322 |                 exit( 1 );
323 |             }
324 |             OGRFeature::DestroyFeature( poFeature );
325 |         }
326 |         GDALClose( poDS );
327 |     }
328 | 
329 | ******************
330 | 数据修改
331 | ******************
332 | GDAL可以添加、删除、修改属性信息和要素，下面简单介绍下如何添加/编辑属性字段(2.x)：
333 | 
334 | .. code-block:: c++
335 | 
336 |     GDALDataset* dst = (GDALDataset*)GDALOpenEx(shpName, GDAL_OF_UPDATE, NULL, NULL, NULL);
337 |     OGRLayer  *poLayer = dst->GetLayer(0);
338 |     OGRFieldDefn oField("imgNo", OFTString);  // Add fields
339 |     oField.SetWidth(128);
340 |     if (poLayer->CreateField(&oField, TRUE) != OGRERR_NONE)
341 |     {
342 |     printf("Creating Name field failed.\n");
343 |     }
344 |     OGRFeature *poFeature;
345 | 
346 |     poLayer->ResetReading();
347 |     while ((poFeature = poLayer->GetNextFeature()) != NULL)
348 |     {
349 |         poFeature->SetField("imgNo", "123456");  // Set fields
350 |         poLayer->SetFeature(poFeature);
351 |         OGRFeature::DestroyFeature(poFeature);
352 |     }
353 |     GDALClose(dst);
354 | 
355 | 
356 | 删除其实也类似,需要注意打开时一定要加上 ``GDAL_OF_UPDATE`` 设置
357 | 
358 | .. code-block:: c++
359 | 
360 |     CPLSetConfigOption("GDAL_FILENAME_IS_UTF8", "NO");
361 |     CPLSetConfigOption("SHAPE_ENCODING", "");
362 |     GDALAllRegister();
363 |     GDALDataset *poDS = (GDALDataset*)GDALOpenEx(strIn.c_str(),\
364 |      GDAL_OF_VECTOR| GDAL_OF_UPDATE, NULL, NULL, NULL);
365 |     
366 |     OGRLayer* pLayer = poDS->GetLayer(0);
367 |     if (!pLayer->TestCapability(OLCDeleteFeature))
368 |     {
369 |         LOGI( "Layer does not support delete feature capability");
370 |     }
371 |     pLayer->DeleteFeature(1);
372 |     pLayer->DeleteFeature(2);
373 |     pLayer->DeleteFeature(3);
374 |     pLayer->DeleteFeature(4);
375 |     pLayer->DeleteFeature(5);
376 |     pLayer->SyncToDisk();
377 |     std::stringstream sql;
378 |     //GDAL版本小于2.2时,shapefile需要这一步才能真正写入
379 |     sql << "REPACK " << pLayer->GetName();
380 |     poDS->ExecuteSQL(sql.str().c_str(), NULL, NULL);
381 |     GDALClose(poDS);
382 | 
383 | 
384 | .. attention::
385 | 
386 |     * GDAL版本小于2.2时,处理shp文件时记得最后要执行 ``REPACK 表名`` ,否则只是临时标记,不会真正删除。
387 |     * GDAL 2.2之后的版本在调用 ``FlushCache()`` 或 ``SyncToDisk()`` 时会自动执行 ``REPACK`` 
388 | 
389 | ******************
390 | 创建空间索引
391 | ******************
392 | 
393 | 有时候合并和处理比较慢,可以尝试先建立空间索引再处理,建空间索引方式跟执行sql一样,调用 ``GDALDataset::ExecuteSQL`` 方法
394 | 
395 | * 删除空间索引  ``DROP SPATIAL INDEX ON tablename``
396 | * 创建空间索引  ``CREATE SPATIAL INDEX ON tablename [DEPTH N]`` N从1-12,指示索引树深度
397 | 
398 | .. code-block:: c++
399 | 
400 |     GDALDataset *poDS = (GDALDataset*)GDALOpenEx(strIn.c_str(),\
401 |      GDAL_OF_VECTOR| GDAL_OF_SHARED, NULL, NULL, NULL);
402 |      OGRLayer* pLayer = poDS->->GetLayer(0);
403 |     std::string strCreateIndex = "CREATE SPATIAL INDEX ON ";
404 |     strCreateIndex += pLayer->GetName();
405 |     //执行创建空间索引的返回是NULL,不需要判断这里
406 |     OGRLayer *idxBase = dsBase->ExecuteSQL(strCreateBase.ToPlatform().c_str(), NULL, NULL);
407 |     ...
408 | 
409 | .. attention::
410 | 
411 |     * 如果表名有空格,在sql里用转义的双引号括起来即可
412 | 


--------------------------------------------------------------------------------
/gdal_3_build.rst:
--------------------------------------------------------------------------------
  1 | .. highlight:: rst
  2 | 
  3 | ################
  4 | GDAL3编译
  5 | ################
  6 | 
  7 | 本篇适用于GDAL3.3的静态编译,环境请参照静态编译,此处就不重复了,此处只编了一些自用的库,如果有啥其他的,可以在issue里提,libpq之类的可以直接用编好的,更方便
  8 | 
  9 | ******************
 10 | 依赖库:
 11 | ******************
 12 | 
 13 | -  PROJ > 6
 14 | 
 15 |    -  SQLite3
 16 |    -  libtiff
 17 | 
 18 |       -  libzip(option)
 19 | 
 20 |    -  curl
 21 | 
 22 | -  LIBICONV
 23 | -  libtiff >= 4.0(option)
 24 | -  Expat
 25 | -  HDF4
 26 | -  HDF5
 27 | -  PostgreSQL
 28 | -  SQLite Libraries
 29 | -  libspatialite
 30 | 
 31 |    -  GEOS
 32 |    -  freexl
 33 |    -  proj
 34 |    -  sqlite3
 35 |    -  zlib
 36 |    -  iconv
 37 |    -  libxml2
 38 |    -  librttopo
 39 |    -  libcurl
 40 |    -  libtiff
 41 | 
 42 | -  PCRE
 43 | -  NETCDF4
 44 | -  curl
 45 | -  geos
 46 | -  Podofo
 47 | 
 48 |    -  freetype
 49 |    -  tiff
 50 |    -  jpeg
 51 | 
 52 | -  LZMA_CFLAGS
 53 | -  ZSTD_LIBS
 54 | -  TILEDB_LIBS
 55 | -  RDB_LIB
 56 | -  WEBP
 57 | -  libxml2
 58 | 
 59 |    -  libiconv
 60 | 
 61 | -  FREEXL
 62 | 
 63 |    -  libiconv
 64 | 
 65 | -  heif
 66 | 
 67 |    -  libde265
 68 | 
 69 | ******************
 70 | 编译顺序:
 71 | ******************
 72 | 
 73 | `libde265 <https://github.com/strukturag/libheif>`__
 74 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 75 | 
 76 | 解压后,按照\ `Fix CMake install issue
 77 | (#278) <https://hub.fastgit.org/strukturag/libde265/pull/280>`__
 78 | 修改cmake文件,然后编译
 79 | 
 80 | 如果需要静态库,修改CMakeLists.txt里的_BUILD_SHARED_LIBS_参数即可
 81 | 
 82 | .. code:: bash
 83 | 
 84 |        cd libde265-1.0.8
 85 |        mkdir build
 86 |        cd build
 87 |        cmake -G "Visual Studio 15 2017 Win64" .. -DCMAKE_INSTALL_PREFIX=e:/GDAL_BUILD/libde265_1.0.8_x64
 88 |        cmake --build . --config Release --target install
 89 | 
 90 | `heif <https://github.com/strukturag/libde265>`__
 91 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 92 | 
 93 | 依赖\ **libde265** ,解压后
 94 | 
 95 | 如果需要静态库,修改CMakeLists.txt里的_BUILD_SHARED_LIBS_参数即可
 96 | 
 97 | .. code:: bash
 98 | 
 99 |        cd libheif-1.12.0
100 |        mkdir build
101 |        cd build
102 |        cmake -G "Visual Studio 15 2017 Win64" ..  -DCMAKE_INSTALL_PREFIX=e:/GDAL_BUILD/libheif_1_12_0_x64 -DLIBDE265_FOUND=ON -DLIBDE265_INCLUDE_DIR=e:/GDAL_BUILD/libde265_1.0.8_x64/include -DLIBDE265_LIBRARIES=e:/GDAL_BUILD/libde265_1.0.8_x64/lib/libde265.lib
103 |        cmake --build . --config Release --target install
104 | 
105 | `curl <https://github.com/curl/curl/releases>`__
106 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
107 | 
108 | libcurl更新比较快,1-2月更新一个版本,请选择最新的版本,可选 ``openssl`` 和
109 | ``zlib`` 等库,自己参考winbuild下readme文档,最简单的编译方式如下:
110 | 
111 | .. code:: bash
112 | 
113 |        cd winbuild
114 |        nmake /f Makefile.vc mode=static
115 | 
116 | 生成文件将在 ``builds`` 文件夹下.需要自己拷贝出来,
117 | 
118 | 在curl.h第一行添加
119 | 
120 | ``define CURL_STATICLIB``
121 | 
122 | `libTiff <http://download.osgeo.org/libtiff/>`__
123 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
124 | 
125 | cmake,依然是修改CmakeList编译静态库
126 | 
127 | .. code:: bash
128 | 
129 |    cd build
130 |    cmake -G "Visual Studio 15 2017 Win64" .. -DCMAKE_INSTALL_PREFIX=e:/GDAL_BUILD/libtiff_4_3_0_x64
131 |    cmake --build . --config Release --target install
132 | 
133 | `sqlite <https://www.sqlite.org/index.html>`__
134 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
135 | 
136 | `sqlite.cmake.build <https://github.com/snikulov/sqlite.cmake.build/tree/master/src>`__\ 中的cmake文件可用
137 | 
138 | .. code:: bash
139 | 
140 |    cd build
141 |    cmake -G "Visual Studio 15 2017 Win64" .. -DCMAKE_INSTALL_PREFIX=e:/GDAL_BUILD/libsqlite3_36_x64
142 |    cmake --build . --config Release --target install
143 | 
144 | `PROJ <https://proj.org/install.html#compilation-and-installation-from-source-code>`__
145 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
146 | 
147 | cmake编译
148 | 
149 | .. code:: bash
150 | 
151 |        cd build
152 |        cmake -G "Visual Studio 15 2017 Win64" .. -DCMAKE_INSTALL_PREFIX=e:/GDAL_BUILD/proj8_1_0_x64 -DBUILD_SHARED_LIBS=OFF -DEXE_SQLITE3=E:\GDAL_BUILD\libsqlite3_36_x64\bin\shell.exe -DSQLITE3_INCLUDE_DIR=E:\GDAL_BUILD\libsqlite3_36_x64\include -DSQLITE3_LIBRARY=E:\GDAL_BUILD\libsqlite3_36_x64\lib\sqlite3-static.lib -DCURL_INCLUDE_DIR=E:\GDAL_BUILD\libcurl-7.77.0-x64\include -DCURL_LIBRARY="E:\GDAL_BUILD\libcurl-7.77.0-x64\lib\libcurl_a.lib;wsock32.lib;wldap32.lib;winmm.lib" -DTIFF_INCLUDE_DIR=E:\GDAL_BUILD\libtiff_4_3_0_x64\include -DTIFF_LIBRARY_RELEASE=E:\GDAL_BUILD\libtiff_4_3_0_x64\lib\tiff.lib -DBUILD_TESTING=OFF
153 | 
154 |        cmake --build . --config Release --target install
155 | 
156 | `libiconv-win-build: <https://github.com/kiyolee/libiconv-win-build>`__
157 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
158 | 
159 | win下编译1.16版本的iconv,直接打开2017工程编译就行
160 | 
161 | `libExpat <https://github.com/libexpat/libexpat/releases>`__
162 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
163 | 
164 | 下载源码后，修改 ``/lib/expat.h`` 文件,在文件首加上：
165 | 
166 | ``define XML_STATIC``
167 | 
168 | 打开命令行,使用cmake
169 | 
170 | .. code:: bash
171 | 
172 |        cd build
173 | 
174 |        cmake -G "Visual Studio 15 2017 Win64" .. -DCMAKE_INSTALL_PREFIX=e:/GDAL_BUILD/liexpat_2_4_1_x64 -DBUILD_SHARED_LIBS=OFF
175 | 
176 |        cmake --build . --config Release --target install
177 | 
178 | `HDF4 <https://support.hdfgroup.org/release4/cmakebuild.html>`__
179 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
180 | 
181 | 尽量使用4.2.12 之后版本,方便编译
182 | 
183 | 直接下载cmake版本,注意是win还是其他,win下载zip压缩,其他下载tar.gz
184 | 
185 | 最新是\ `4.2.15 <https://portal.hdfgroup.org/display/support/HDF+4.2.15#files>`__\ 版本,,下载\ `CMake-hdf-4.2.15.zip <https://support.hdfgroup.org/ftp/HDF/releases/HDF4.2.15/src/CMake-hdf-4.2.15.zip>`__
186 | 
187 | 修改其中的 HDF4options.cmake 文件,文件末尾添加
188 | 
189 | ``set(ADD_BUILD_OPTIONS "${ADD_BUILD_OPTIONS} -DHDF4_ENABLE_NETCDF:BOOL=OFF")``
190 | 
191 | 防止与 netcdf 库冲突
192 | 
193 | 同时取消注释,编译静态库
194 | 
195 | ``set (ADD_BUILD_OPTIONS "${ADD_BUILD_OPTIONS} -DBUILD_SHARED_LIBS:BOOL=OFF")``
196 | 
197 | 下载完成后,根据Visual Studio版本,运行相应的 ``build-VS20xx-32.bat`` 或者
198 | ``build-VS20xx-64.bat`` 文件,会自动新建build文件夹,最终在 build
199 | 文件夹下生成zip文件.
200 | 
201 | 老版本或者新版本的Visual Studio可直接编辑 HDF4config.cmake
202 | 文件,仿照其他bat文件写脚本.
203 | 
204 | `HDF5 <https://www.hdfgroup.org/downloads/hdf5/source-code/>`__
205 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
206 | 
207 | 基本与hdf4一样,下载\ `cmake <https://www.hdfgroup.org/package/cmake-hdf5-1-12-0-zip/?wpdmdl=14583&refresh=60e79b3625edd1625791286>`__\ 版本,修改HDF5options.cmake文件,取消注释,最后加上一行
208 | 
209 | .. code:: cmake
210 | 
211 |    set (ADD_BUILD_OPTIONS "${ADD_BUILD_OPTIONS} -DBUILD_SHARED_LIBS:BOOL=OFF")
212 |    #add# at last
213 |    set (ADD_BUILD_OPTIONS ${ADD_BUILD_OPTIONS} -DDEFAULT_API_VERSION:STRING=v18")
214 | 
215 | 即静态编译后,双击bat即可
216 | 
217 | `NetCDF <https://hub.fastgit.org/Unidata/netcdf-c>`__
218 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
219 | 
220 | 注意:
221 | 
222 | 1. hdf5需要加DEAFAULT_API_VESION=v18
223 | 
224 | 2. 改cmakelist.txt文件 : `Use of unset variable HDF5_VERSION · Issue
225 |    #1962 · Unidata/netcdf-c · GitHub
226 |    (fastgit.org) <https://hub.fastgit.org/Unidata/netcdf-c/issues/1962>`__
227 | 
228 | 3. 在utf8环境下编译
229 | 
230 | 4. 屏蔽掉\ ``netcdf-c-4.8.0\nc_test4\tst_udf.c``\ 中的19-26行
231 | 
232 |    .. code:: cpp
233 | 
234 |       /*
235 |       #if# defined(_WIN32) || defined(_WIN64)
236 |       int
237 |       NC4_show_metadata(int ncid)
238 |       {
239 |       return 0;
240 |       }
241 |       #endif#
242 |       */
243 | 
244 | 编译
245 | 
246 | .. code:: bash
247 | 
248 |        chcp 65001
249 |        mkdir build
250 |        cd build
251 |        cmake  -G "Visual Studio 15 2017 Win64" .. -DCMAKE_INSTALL_PREFIX=e:/GDAL_BUILD/netcdf_4_8_0_x64 -DBUILD_SHARED_LIBS=OFF  -DUSE_SZIP=ON -DUSE_HDF5=ON -DENABLE_DAP=ON -D"SZIP=E:/GDAL_BUILD/HDF5-1.12.0-win64/lib/libszip.lib” -D"ZLIB_INCLUDE_DIR=E:/GDAL_BUILD/SOURCE/CMake-hdf5-1.12.0/build/ZLIB-prefix/src/ZLIB" -D"ZLIB_LIBRARY=E:/GDAL_BUILD/HDF5-1.12.0-win64/lib/libzlib.lib"  -DENABLE_NETCDF_4=ON -D"CURL_LIBRARY=E:/GDAL_BUILD/libcurl-7.77.0-x64/lib/libcurl_a.lib;wsock32.lib;wldap32.lib;winmm.lib;crypt32.lib;Ws2_32.lib;Normaliz.lib"  -D"CURL_INCLUDE_DIR=E:/GDAL_BUILD/libcurl-7.77.0-x64/include"  -D"HAVE_HDF5_H=E:/GDAL_BUILD/HDF5-1.12.0-win64/include"  -D"HDF5_INCLUDE_DIR=E:/GDAL_BUILD/HDF5-1.12.0-win64/include"  -D"HDF5_C_LIBRARY=E:/GDAL_BUILD/HDF5-1.12.0-win64/lib/libhdf5.lib"  -D"HDF5_HL_LIBRARY=E:/GDAL_BUILD/HDF5-1.12.0-win64/lib/libhdf5_hl.lib" -DBUILD_TESTING=OFF
252 | 
253 |        cmake --build . --config Release --target install
254 | 
255 | `GEOS <https://git.osgeo.org/gitea/geos/geos>`__
256 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
257 | 
258 | 新版本的 ``geos`` 直接采用 ``cmake`` 可以生成静态库和动态库。
259 | 
260 | .. code:: bash
261 | 
262 |        cd build
263 | 
264 |        cmake -G "Visual Studio 15 2017 Win64" .. -DCMAKE_INSTALL_PREFIX=e:/GDAL_BUILD/GEOS_3_9_1_x64 -DBUILD_SHARED_LIBS=OFF
265 | 
266 |        cmake --build . --config Release --target install
267 | 
268 | `podofo <http://podofo.sourceforge.net/>`__
269 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
270 | 
271 | .. code:: bash
272 | 
273 |        del cmakecache.txt
274 |        set FTDIR=E:/GDAL_BUILD/freetype_2.10.4_x64
275 |        set FTLIBDIR=E:/GDAL_BUILD/freetype_2.10.4_x64/release static/win64
276 |        set ZLIBDIR=E:/GDAL_BUILD/HDF5-1.12.0-win64
277 |        set TIFDIR=E:/GDAL_BUILD/libtiff_4_3_0_x64
278 | 
279 |        cmake -G "Visual Studio 15 2017 Win64" .. -DCMAKE_INCLUDE_PATH="%FTDIR%/include;%JPEGDIR%/include;%ZLIBDIR%/include;%TIFDIR%/include" -DCMAKE_LIBRARY_PATH="%FTLIBDIR%;%FTDIR%/lib;%ZLIBDIR%/lib;%TIFDIR%/lib" -DPODOFO_BUILD_SHARED:BOOL=FALSE -DFREETYPE_LIBRARY_NAMES=freetype -DZLIB_LIBRARY_NAMES=libzlib -DTIFF_LIBRARY_NAMES=libTiff -DZLIB_INCLUDE_DIR=%ZLIBDIR%/include -DCMAKE_INSTALL_PREFIX=e:/GDAL_BUILD/podofo_0_9_7_x64
280 | 
281 |        cmake --build . --config Release --target install
282 | 
283 | `FreeType <https://sourceforge.net/projects/freetype/>`__
284 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
285 | 
286 | 可以直接下载编译好的\ `2.10.4 <https://github.com/ubawurinna/freetype-windows-binaries>`__\ 版本,其中有动态版本和静态版本,没有尝试编译
287 | 
288 | `FreeXL <https://www.gaia-gis.it/fossil/freexl/index>`__
289 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
290 | 
291 | 1. 修改nmake.opt中的输出路径
292 | 2. 修改makefile.vc中iconv库路径和头文件路径
293 |    ``nmake /f makefile.vc install``
294 | 
295 | `LibXML2 <http://xmlsoft.org/>`__
296 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
297 | 
298 | -  进入 ``win32`` 文件夹下,运行,注意编译静态库需要 static=yes 和
299 |    cruntime=/MT 同时设置
300 | 
301 |    .. code:: bash
302 | 
303 |       cscript configure.js  static=yes compiler=msvc prefix=E:\GDAL_BUILD\libxml2-2.9.12_x64 include=E:\GDAL_BUILD\iconv1.16\include lib=E:\GDAL_BUILD\iconv1.16\lib cruntime=/MT
304 | 
305 |       nmake /f Makefile.msvc
306 |       nmake /f Makefile.msvc install
307 | 
308 | 编译完成后,在头文件中定义 LIBXML_STATIC 宏
309 | 
310 | `Librttopo <https://git.osgeo.org/gitea/rttopo/librttopo>`__
311 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
312 | 
313 | -  修改 ``makefile.vc`` 中的geos头文件和lib文件路径
314 | 
315 | -  修改 ``nmake.opt`` 中的安装路径 INSTDIR
316 | 
317 | -  下载 `#25 - Handle missing 2 header files when compiling on
318 |    Windows  <https://git.osgeo.org/gitea/rttopo/librttopo/issues/25>`__
319 |    中的两个文件
320 | 
321 | -  在makefile.vc中第20行添加 ``src\rtt_tpsnap.obj``
322 |     下面编译spatialite需要
323 | 
324 | -  在vs命令行中编译
325 | 
326 |    .. code:: bash
327 | 
328 |       nmake /f Makefile.vc
329 |       nmake /f Makefile.vc install
330 | 
331 | zlib
332 | ^^^^
333 | 
334 | cmake-hdf5里有压缩文件夹,可以直接解压编译,不需要重复下载
335 | 
336 | .. code:: bash
337 | 
338 |    mkdir build
339 |        cd build
340 |        cmake -G "Visual Studio 15 2017 Win64" .. -DCMAKE_INSTALL_PREFIX=e:/GDAL_BUILD/zlib_x64
341 |        cmake --build . --config Release --target install
342 | 
343 | `libspatialite <https://www.gaia-gis.it/fossil/libspatialite/index>`__
344 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
345 | 
346 | 修改 ``gg_utf8.c`` 文件中72行,注释掉
347 | 
348 | ``extern const char *locale_charset (void);``
349 | 
350 | 替换为
351 | 
352 | ``include <localcharset.h>``
353 | 
354 | 修改nmake.opt 中的输出路径
355 | 
356 | 修改makefile64.vc中头文件
357 | -I和lib的路径,所有路径都得改,主要是头文件和lib这两段,请按实际情况修改
358 | 
359 | .. code:: make
360 | 
361 |        CFLAGS = /nologo -I.\src\headers -I.\src\topology   -I.  -IE:\GDAL_BUILD\proj8_1_0_x64\include  -IE:\GDAL_BUILD\GEOS_3_9_1_x64\include  -IE:\GDAL_BUILD\iconv1.16\include -IE:\GDAL_BUILD\freeXL1_0_6_X64\include  -IE:\GDAL_BUILD\libcurl-7.77.0-x64\include  -IE:\GDAL_BUILD\libtiff_4_3_0_x64\include -IE:\GDAL_BUILD\libsqlite3_36_x64\include -IE:\GDAL_BUILD\zlib_x64\include -IE:\GDAL_BUILD\libxml2-2.9.12_x64\include\libxml2 -IE:\GDAL_BUILD\librttopo1_1_0_x64\include $(OPTFLAGS)
362 | 
363 |        ...
364 | 
365 |        spatialite_i.lib:     $(LIBOBJ)
366 |            link /dll /out:$(SPATIALITE_DLL) \
367 |            /implib:spatialite_i.lib $(LIBOBJ) \
368 |            E:\GDAL_BUILD\proj8_1_0_x64\lib\proj.lib  E:\GDAL_BUILD\GEOS_3_9_1_x64\lib\geos_c.lib E:\GDAL_BUILD\GEOS_3_9_1_x64\lib\geos.lib\
369 |            E:\GDAL_BUILD\freeXL1_0_6_X64\lib\freexl.lib E:\GDAL_BUILD\iconv1.16\lib\libiconv-static.lib \
370 |            E:\GDAL_BUILD\libsqlite3_36_x64\lib\sqlite3-static.lib E:\GDAL_BUILD\zlib_x64\lib\libzlib.lib \
371 |                E:\GDAL_BUILD\libxml2-2.9.12_x64\lib\libxml2_a.lib E:\GDAL_BUILD\librttopo1_1_0_x64\lib\librttopo.lib \
372 |            E:\GDAL_BUILD\libtiff_4_3_0_x64\lib\tiff.lib E:\GDAL_BUILD\libtiff_4_3_0_x64\lib\tiffxx.lib \           E:\GDAL_BUILD\libcurl-7.77.0-x64\lib\libcurl_a.lib wsock32.lib shell32.lib wldap32.lib winmm.lib crypt32.lib Ws2_32.lib Normaliz.lib  Ole32.lib Advapi32.lib
373 | 
374 | 然后
375 | 
376 | .. code:: bash
377 | 
378 |    nmake /f Makefile.vc
379 |    nmake /f Makefile.vc install
380 | 
381 | 拷贝sqlite3.h的头文件到include和include/spatialite 里备用
382 | 
383 | `PCRE <http://www.pcre.org/>`__
384 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
385 | 
386 | ::
387 | 
388 |        cd build
389 |        cmake -G "Visual Studio 15 2017 Win64" .. -DCMAKE_INSTALL_PREFIX=e:/GDAL_BUILD/PCRE_x64
390 |        cmake --build . --config Release --target install
391 | 
392 | pcre2在gdal中是无效的,注意,需要pcre1,但是已经不怎么维护了
393 | 
394 | `GDAL <https://gdal.org/>`__
395 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
396 | 
397 | 修改nmake.opt,添加依赖和修改编译环境,然后运行
398 | 
399 | 注意:
400 | 
401 | 1. 如果需要编HDF NETCDF等库的plugin模式,请编译动态库,不要静态库
402 | 2. 注意依赖关系,libspatalite库的其他依赖,hdf和netcdf的其他依赖需要带上
403 | 3. 注意头文件中静态宏的声明
404 | 4. 编译gdal静态库的话,修改nmake.opt 设置 ``DLLBUILD=0``
405 |    ,静态库编译比较占空间,其实不太推荐,其他库都是静态,编出来gdal303.dll不到30M,lib
406 |    2M,总体30M,静态编出来的话lib接近300M,编出来的工具大概就是30M,总体接近1G,不过好处是干净,看着没啥依赖,请按实际需求进行编译
407 | 5. 编译后,建议先设置PROJ_LIB环境变量,或者在代码中调用
408 |    ``OSRSetPROJSearchPaths``
409 |    设置proj.db的路径,gdal3中主要变化一个是编译都升级到c++11,另一个就是proj库升级到6以上,支持WKT2了,不加上的话会出现找不到proj.db的错误
410 | 


--------------------------------------------------------------------------------
/theme/sphinx_rtd_theme/static/js/modernizr.min.js:
--------------------------------------------------------------------------------
1 | /* Modernizr 2.6.2 (Custom Build) | MIT & BSD
2 |  * Build: http://modernizr.com/download/#-fontface-backgroundsize-borderimage-borderradius-boxshadow-flexbox-hsla-multiplebgs-opacity-rgba-textshadow-cssanimations-csscolumns-generatedcontent-cssgradients-cssreflections-csstransforms-csstransforms3d-csstransitions-applicationcache-canvas-canvastext-draganddrop-hashchange-history-audio-video-indexeddb-input-inputtypes-localstorage-postmessage-sessionstorage-websockets-websqldatabase-webworkers-geolocation-inlinesvg-smil-svg-svgclippaths-touch-webgl-shiv-mq-cssclasses-addtest-prefixed-teststyles-testprop-testallprops-hasevent-prefixes-domprefixes-load
3 |  */
4 | ;window.Modernizr=function(a,b,c){function D(a){j.cssText=a}function E(a,b){return D(n.join(a+";")+(b||""))}function F(a,b){return typeof a===b}function G(a,b){return!!~(""+a).indexOf(b)}function H(a,b){for(var d in a){var e=a[d];if(!G(e,"-")&&j[e]!==c)return b=="pfx"?e:!0}return!1}function I(a,b,d){for(var e in a){var f=b[a[e]];if(f!==c)return d===!1?a[e]:F(f,"function")?f.bind(d||b):f}return!1}function J(a,b,c){var d=a.charAt(0).toUpperCase()+a.slice(1),e=(a+" "+p.join(d+" ")+d).split(" ");return F(b,"string")||F(b,"undefined")?H(e,b):(e=(a+" "+q.join(d+" ")+d).split(" "),I(e,b,c))}function K(){e.input=function(c){for(var d=0,e=c.length;d<e;d++)u[c[d]]=c[d]in k;return u.list&&(u.list=!!b.createElement("datalist")&&!!a.HTMLDataListElement),u}("autocomplete autofocus list placeholder max min multiple pattern required step".split(" ")),e.inputtypes=function(a){for(var d=0,e,f,h,i=a.length;d<i;d++)k.setAttribute("type",f=a[d]),e=k.type!=="text",e&&(k.value=l,k.style.cssText="position:absolute;visibility:hidden;",/^range$/.test(f)&&k.style.WebkitAppearance!==c?(g.appendChild(k),h=b.defaultView,e=h.getComputedStyle&&h.getComputedStyle(k,null).WebkitAppearance!=="textfield"&&k.offsetHeight!==0,g.removeChild(k)):/^(search|tel)$/.test(f)||(/^(url|email)$/.test(f)?e=k.checkValidity&&k.checkValidity()===!1:e=k.value!=l)),t[a[d]]=!!e;return t}("search tel url email datetime date month week time datetime-local number range color".split(" "))}var d="2.6.2",e={},f=!0,g=b.documentElement,h="modernizr",i=b.createElement(h),j=i.style,k=b.createElement("input"),l=":)",m={}.toString,n=" -webkit- -moz- -o- -ms- ".split(" "),o="Webkit Moz O ms",p=o.split(" "),q=o.toLowerCase().split(" "),r={svg:"http://www.w3.org/2000/svg"},s={},t={},u={},v=[],w=v.slice,x,y=function(a,c,d,e){var f,i,j,k,l=b.createElement("div"),m=b.body,n=m||b.createElement("body");if(parseInt(d,10))while(d--)j=b.createElement("div"),j.id=e?e[d]:h+(d+1),l.appendChild(j);return f=["&#173;",'<style id="s',h,'">',a,"</style>"].join(""),l.id=h,(m?l:n).innerHTML+=f,n.appendChild(l),m||(n.style.background="",n.style.overflow="hidden",k=g.style.overflow,g.style.overflow="hidden",g.appendChild(n)),i=c(l,a),m?l.parentNode.removeChild(l):(n.parentNode.removeChild(n),g.style.overflow=k),!!i},z=function(b){var c=a.matchMedia||a.msMatchMedia;if(c)return c(b).matches;var d;return y("@media "+b+" { #"+h+" { position: absolute; } }",function(b){d=(a.getComputedStyle?getComputedStyle(b,null):b.currentStyle)["position"]=="absolute"}),d},A=function(){function d(d,e){e=e||b.createElement(a[d]||"div"),d="on"+d;var f=d in e;return f||(e.setAttribute||(e=b.createElement("div")),e.setAttribute&&e.removeAttribute&&(e.setAttribute(d,""),f=F(e[d],"function"),F(e[d],"undefined")||(e[d]=c),e.removeAttribute(d))),e=null,f}var a={select:"input",change:"input",submit:"form",reset:"form",error:"img",load:"img",abort:"img"};return d}(),B={}.hasOwnProperty,C;!F(B,"undefined")&&!F(B.call,"undefined")?C=function(a,b){return B.call(a,b)}:C=function(a,b){return b in a&&F(a.constructor.prototype[b],"undefined")},Function.prototype.bind||(Function.prototype.bind=function(b){var c=this;if(typeof c!="function")throw new TypeError;var d=w.call(arguments,1),e=function(){if(this instanceof e){var a=function(){};a.prototype=c.prototype;var f=new a,g=c.apply(f,d.concat(w.call(arguments)));return Object(g)===g?g:f}return c.apply(b,d.concat(w.call(arguments)))};return e}),s.flexbox=function(){return J("flexWrap")},s.canvas=function(){var a=b.createElement("canvas");return!!a.getContext&&!!a.getContext("2d")},s.canvastext=function(){return!!e.canvas&&!!F(b.createElement("canvas").getContext("2d").fillText,"function")},s.webgl=function(){return!!a.WebGLRenderingContext},s.touch=function(){var c;return"ontouchstart"in a||a.DocumentTouch&&b instanceof DocumentTouch?c=!0:y(["@media (",n.join("touch-enabled),("),h,")","{#modernizr{top:9px;position:absolute}}"].join(""),function(a){c=a.offsetTop===9}),c},s.geolocation=function(){return"geolocation"in navigator},s.postmessage=function(){return!!a.postMessage},s.websqldatabase=function(){return!!a.openDatabase},s.indexedDB=function(){return!!J("indexedDB",a)},s.hashchange=function(){return A("hashchange",a)&&(b.documentMode===c||b.documentMode>7)},s.history=function(){return!!a.history&&!!history.pushState},s.draganddrop=function(){var a=b.createElement("div");return"draggable"in a||"ondragstart"in a&&"ondrop"in a},s.websockets=function(){return"WebSocket"in a||"MozWebSocket"in a},s.rgba=function(){return D("background-color:rgba(150,255,150,.5)"),G(j.backgroundColor,"rgba")},s.hsla=function(){return D("background-color:hsla(120,40%,100%,.5)"),G(j.backgroundColor,"rgba")||G(j.backgroundColor,"hsla")},s.multiplebgs=function(){return D("background:url(https://),url(https://),red url(https://)"),/(url\s*\(.*?){3}/.test(j.background)},s.backgroundsize=function(){return J("backgroundSize")},s.borderimage=function(){return J("borderImage")},s.borderradius=function(){return J("borderRadius")},s.boxshadow=function(){return J("boxShadow")},s.textshadow=function(){return b.createElement("div").style.textShadow===""},s.opacity=function(){return E("opacity:.55"),/^0.55$/.test(j.opacity)},s.cssanimations=function(){return J("animationName")},s.csscolumns=function(){return J("columnCount")},s.cssgradients=function(){var a="background-image:",b="gradient(linear,left top,right bottom,from(#9f9),to(white));",c="linear-gradient(left top,#9f9, white);";return D((a+"-webkit- ".split(" ").join(b+a)+n.join(c+a)).slice(0,-a.length)),G(j.backgroundImage,"gradient")},s.cssreflections=function(){return J("boxReflect")},s.csstransforms=function(){return!!J("transform")},s.csstransforms3d=function(){var a=!!J("perspective");return a&&"webkitPerspective"in g.style&&y("@media (transform-3d),(-webkit-transform-3d){#modernizr{left:9px;position:absolute;height:3px;}}",function(b,c){a=b.offsetLeft===9&&b.offsetHeight===3}),a},s.csstransitions=function(){return J("transition")},s.fontface=function(){var a;return y('@font-face {font-family:"font";src:url("https://")}',function(c,d){var e=b.getElementById("smodernizr"),f=e.sheet||e.styleSheet,g=f?f.cssRules&&f.cssRules[0]?f.cssRules[0].cssText:f.cssText||"":"";a=/src/i.test(g)&&g.indexOf(d.split(" ")[0])===0}),a},s.generatedcontent=function(){var a;return y(["#",h,"{font:0/0 a}#",h,':after{content:"',l,'";visibility:hidden;font:3px/1 a}'].join(""),function(b){a=b.offsetHeight>=3}),a},s.video=function(){var a=b.createElement("video"),c=!1;try{if(c=!!a.canPlayType)c=new Boolean(c),c.ogg=a.canPlayType('video/ogg; codecs="theora"').replace(/^no$/,""),c.h264=a.canPlayType('video/mp4; codecs="avc1.42E01E"').replace(/^no$/,""),c.webm=a.canPlayType('video/webm; codecs="vp8, vorbis"').replace(/^no$/,"")}catch(d){}return c},s.audio=function(){var a=b.createElement("audio"),c=!1;try{if(c=!!a.canPlayType)c=new Boolean(c),c.ogg=a.canPlayType('audio/ogg; codecs="vorbis"').replace(/^no$/,""),c.mp3=a.canPlayType("audio/mpeg;").replace(/^no$/,""),c.wav=a.canPlayType('audio/wav; codecs="1"').replace(/^no$/,""),c.m4a=(a.canPlayType("audio/x-m4a;")||a.canPlayType("audio/aac;")).replace(/^no$/,"")}catch(d){}return c},s.localstorage=function(){try{return localStorage.setItem(h,h),localStorage.removeItem(h),!0}catch(a){return!1}},s.sessionstorage=function(){try{return sessionStorage.setItem(h,h),sessionStorage.removeItem(h),!0}catch(a){return!1}},s.webworkers=function(){return!!a.Worker},s.applicationcache=function(){return!!a.applicationCache},s.svg=function(){return!!b.createElementNS&&!!b.createElementNS(r.svg,"svg").createSVGRect},s.inlinesvg=function(){var a=b.createElement("div");return a.innerHTML="<svg/>",(a.firstChild&&a.firstChild.namespaceURI)==r.svg},s.smil=function(){return!!b.createElementNS&&/SVGAnimate/.test(m.call(b.createElementNS(r.svg,"animate")))},s.svgclippaths=function(){return!!b.createElementNS&&/SVGClipPath/.test(m.call(b.createElementNS(r.svg,"clipPath")))};for(var L in s)C(s,L)&&(x=L.toLowerCase(),e[x]=s[L](),v.push((e[x]?"":"no-")+x));return e.input||K(),e.addTest=function(a,b){if(typeof a=="object")for(var d in a)C(a,d)&&e.addTest(d,a[d]);else{a=a.toLowerCase();if(e[a]!==c)return e;b=typeof b=="function"?b():b,typeof f!="undefined"&&f&&(g.className+=" "+(b?"":"no-")+a),e[a]=b}return e},D(""),i=k=null,function(a,b){function k(a,b){var c=a.createElement("p"),d=a.getElementsByTagName("head")[0]||a.documentElement;return c.innerHTML="x<style>"+b+"</style>",d.insertBefore(c.lastChild,d.firstChild)}function l(){var a=r.elements;return typeof a=="string"?a.split(" "):a}function m(a){var b=i[a[g]];return b||(b={},h++,a[g]=h,i[h]=b),b}function n(a,c,f){c||(c=b);if(j)return c.createElement(a);f||(f=m(c));var g;return f.cache[a]?g=f.cache[a].cloneNode():e.test(a)?g=(f.cache[a]=f.createElem(a)).cloneNode():g=f.createElem(a),g.canHaveChildren&&!d.test(a)?f.frag.appendChild(g):g}function o(a,c){a||(a=b);if(j)return a.createDocumentFragment();c=c||m(a);var d=c.frag.cloneNode(),e=0,f=l(),g=f.length;for(;e<g;e++)d.createElement(f[e]);return d}function p(a,b){b.cache||(b.cache={},b.createElem=a.createElement,b.createFrag=a.createDocumentFragment,b.frag=b.createFrag()),a.createElement=function(c){return r.shivMethods?n(c,a,b):b.createElem(c)},a.createDocumentFragment=Function("h,f","return function(){var n=f.cloneNode(),c=n.createElement;h.shivMethods&&("+l().join().replace(/\w+/g,function(a){return b.createElem(a),b.frag.createElement(a),'c("'+a+'")'})+");return n}")(r,b.frag)}function q(a){a||(a=b);var c=m(a);return r.shivCSS&&!f&&!c.hasCSS&&(c.hasCSS=!!k(a,"article,aside,figcaption,figure,footer,header,hgroup,nav,section{display:block}mark{background:#FF0;color:#000}")),j||p(a,c),a}var c=a.html5||{},d=/^<|^(?:button|map|select|textarea|object|iframe|option|optgroup)$/i,e=/^(?:a|b|code|div|fieldset|h1|h2|h3|h4|h5|h6|i|label|li|ol|p|q|span|strong|style|table|tbody|td|th|tr|ul)$/i,f,g="_html5shiv",h=0,i={},j;(function(){try{var a=b.createElement("a");a.innerHTML="<xyz></xyz>",f="hidden"in a,j=a.childNodes.length==1||function(){b.createElement("a");var a=b.createDocumentFragment();return typeof a.cloneNode=="undefined"||typeof a.createDocumentFragment=="undefined"||typeof a.createElement=="undefined"}()}catch(c){f=!0,j=!0}})();var r={elements:c.elements||"abbr article aside audio bdi canvas data datalist details figcaption figure footer header hgroup mark meter nav output progress section summary time video",shivCSS:c.shivCSS!==!1,supportsUnknownElements:j,shivMethods:c.shivMethods!==!1,type:"default",shivDocument:q,createElement:n,createDocumentFragment:o};a.html5=r,q(b)}(this,b),e._version=d,e._prefixes=n,e._domPrefixes=q,e._cssomPrefixes=p,e.mq=z,e.hasEvent=A,e.testProp=function(a){return H([a])},e.testAllProps=J,e.testStyles=y,e.prefixed=function(a,b,c){return b?J(a,b,c):J(a,"pfx")},g.className=g.className.replace(/(^|\s)no-js(\s|$)/,"$1$2")+(f?" js "+v.join(" "):""),e}(this,this.document),function(a,b,c){function d(a){return"[object Function]"==o.call(a)}function e(a){return"string"==typeof a}function f(){}function g(a){return!a||"loaded"==a||"complete"==a||"uninitialized"==a}function h(){var a=p.shift();q=1,a?a.t?m(function(){("c"==a.t?B.injectCss:B.injectJs)(a.s,0,a.a,a.x,a.e,1)},0):(a(),h()):q=0}function i(a,c,d,e,f,i,j){function k(b){if(!o&&g(l.readyState)&&(u.r=o=1,!q&&h(),l.onload=l.onreadystatechange=null,b)){"img"!=a&&m(function(){t.removeChild(l)},50);for(var d in y[c])y[c].hasOwnProperty(d)&&y[c][d].onload()}}var j=j||B.errorTimeout,l=b.createElement(a),o=0,r=0,u={t:d,s:c,e:f,a:i,x:j};1===y[c]&&(r=1,y[c]=[]),"object"==a?l.data=c:(l.src=c,l.type=a),l.width=l.height="0",l.onerror=l.onload=l.onreadystatechange=function(){k.call(this,r)},p.splice(e,0,u),"img"!=a&&(r||2===y[c]?(t.insertBefore(l,s?null:n),m(k,j)):y[c].push(l))}function j(a,b,c,d,f){return q=0,b=b||"j",e(a)?i("c"==b?v:u,a,b,this.i++,c,d,f):(p.splice(this.i++,0,a),1==p.length&&h()),this}function k(){var a=B;return a.loader={load:j,i:0},a}var l=b.documentElement,m=a.setTimeout,n=b.getElementsByTagName("script")[0],o={}.toString,p=[],q=0,r="MozAppearance"in l.style,s=r&&!!b.createRange().compareNode,t=s?l:n.parentNode,l=a.opera&&"[object Opera]"==o.call(a.opera),l=!!b.attachEvent&&!l,u=r?"object":l?"script":"img",v=l?"script":u,w=Array.isArray||function(a){return"[object Array]"==o.call(a)},x=[],y={},z={timeout:function(a,b){return b.length&&(a.timeout=b[0]),a}},A,B;B=function(a){function b(a){var a=a.split("!"),b=x.length,c=a.pop(),d=a.length,c={url:c,origUrl:c,prefixes:a},e,f,g;for(f=0;f<d;f++)g=a[f].split("="),(e=z[g.shift()])&&(c=e(c,g));for(f=0;f<b;f++)c=x[f](c);return c}function g(a,e,f,g,h){var i=b(a),j=i.autoCallback;i.url.split(".").pop().split("?").shift(),i.bypass||(e&&(e=d(e)?e:e[a]||e[g]||e[a.split("/").pop().split("?")[0]]),i.instead?i.instead(a,e,f,g,h):(y[i.url]?i.noexec=!0:y[i.url]=1,f.load(i.url,i.forceCSS||!i.forceJS&&"css"==i.url.split(".").pop().split("?").shift()?"c":c,i.noexec,i.attrs,i.timeout),(d(e)||d(j))&&f.load(function(){k(),e&&e(i.origUrl,h,g),j&&j(i.origUrl,h,g),y[i.url]=2})))}function h(a,b){function c(a,c){if(a){if(e(a))c||(j=function(){var a=[].slice.call(arguments);k.apply(this,a),l()}),g(a,j,b,0,h);else if(Object(a)===a)for(n in m=function(){var b=0,c;for(c in a)a.hasOwnProperty(c)&&b++;return b}(),a)a.hasOwnProperty(n)&&(!c&&!--m&&(d(j)?j=function(){var a=[].slice.call(arguments);k.apply(this,a),l()}:j[n]=function(a){return function(){var b=[].slice.call(arguments);a&&a.apply(this,b),l()}}(k[n])),g(a[n],j,b,n,h))}else!c&&l()}var h=!!a.test,i=a.load||a.both,j=a.callback||f,k=j,l=a.complete||f,m,n;c(h?a.yep:a.nope,!!i),i&&c(i)}var i,j,l=this.yepnope.loader;if(e(a))g(a,0,l,0);else if(w(a))for(i=0;i<a.length;i++)j=a[i],e(j)?g(j,0,l,0):w(j)?B(j):Object(j)===j&&h(j,l);else Object(a)===a&&h(a,l)},B.addPrefix=function(a,b){z[a]=b},B.addFilter=function(a){x.push(a)},B.errorTimeout=1e4,null==b.readyState&&b.addEventListener&&(b.readyState="loading",b.addEventListener("DOMContentLoaded",A=function(){b.removeEventListener("DOMContentLoaded",A,0),b.readyState="complete"},0)),a.yepnope=k(),a.yepnope.executeStack=h,a.yepnope.injectJs=function(a,c,d,e,i,j){var k=b.createElement("script"),l,o,e=e||B.errorTimeout;k.src=a;for(o in d)k.setAttribute(o,d[o]);c=j?h:c||f,k.onreadystatechange=k.onload=function(){!l&&g(k.readyState)&&(l=1,c(),k.onload=k.onreadystatechange=null)},m(function(){l||(l=1,c(1))},e),i?k.onload():n.parentNode.insertBefore(k,n)},a.yepnope.injectCss=function(a,c,d,e,g,i){var e=b.createElement("link"),j,c=i?h:c||f;e.href=a,e.rel="stylesheet",e.type="text/css";for(j in d)e.setAttribute(j,d[j]);g||(n.parentNode.insertBefore(e,n),m(c,0))}}(this,document),Modernizr.load=function(){yepnope.apply(window,[].slice.call(arguments,0))};
5 | 


--------------------------------------------------------------------------------
/gdal-cheat-sheet.rst:
--------------------------------------------------------------------------------
  1 | .. highlight:: rst
  2 | .. _CheatSheet:
  3 | 
  4 | ############################
  5 | GDAL Cheat Sheet
  6 | ############################
  7 | 本文为 ``GitHub`` 上的项目，原项目地址： https://github.com/dwtkns/gdal-cheat-sheet
  8 | 
  9 | ********************
 10 | Vector operations
 11 | ********************
 12 | 
 13 | **Get vector information**
 14 | 
 15 | ::
 16 | 
 17 |     ogrinfo -so input.shp layer-name
 18 | 
 19 | Or, for all layers
 20 | 
 21 | ::
 22 | 
 23 |     ogrinfo -al -so input.shp
 24 | 
 25 | **Print vector extent**
 26 | 
 27 | ::
 28 | 
 29 |     ogrinfo input.shp layer-name | grep Extent
 30 | 
 31 | **List vector drivers**
 32 | 
 33 | ::
 34 | 
 35 |     ogr2ogr --formats
 36 | 
 37 | **Convert between vector formats**
 38 | 
 39 | ::
 40 | 
 41 |     ogr2ogr -f "GeoJSON" output.json input.shp
 42 | 
 43 | **Clip vectors by bounding box**
 44 | 
 45 | ::
 46 | 
 47 |     ogr2ogr -f "ESRI Shapefile" output.shp input.shp -clipsrc 
 48 |             <x_min> <y_min> <x_max> <y_max>
 49 | 
 50 | **Clip one vector by another**
 51 | 
 52 | ::
 53 | 
 54 |     ogr2ogr -clipsrc clipping_polygon.shp output.shp input.shp
 55 | 
 56 | **Reproject vector:**
 57 | 
 58 | ::
 59 | 
 60 |     ogr2ogr output.shp -t_srs "EPSG:4326" input.shp
 61 | 
 62 | **Merge features in a vector file by attribute ("dissolve")**
 63 | 
 64 | ::
 65 | 
 66 |     ogr2ogr -f "ESRI Shapefile" dissolved.shp input.shp -dialect sqlite -sql 
 67 |       "select ST_union(Geometry),common_attribute from input GROUP BY common_attribute"
 68 | 
 69 | **Merge vector files:**
 70 | 
 71 | ::
 72 | 
 73 |     ogr2ogr merged.shp input1.shp
 74 |     ogr2ogr -update -append merged.shp input2.shp -nln merged
 75 | 
 76 | **Extract from a vector file based on query**
 77 | 
 78 | To extract features with STATENAME 'New York','New Hampshire', etc. from
 79 | states.shp
 80 | 
 81 | ::
 82 | 
 83 |     ogr2ogr -where 'STATENAME like "New%"' states_subset.shp states.shp
 84 | 
 85 | To extract type 'pond' from water.shp
 86 | 
 87 | ::
 88 | 
 89 |     ogr2ogr -where "type = pond" ponds.shp water.shp
 90 | 
 91 | **Subset & filter all shapefiles in a directory**
 92 | 
 93 | Assumes that filename and name of layer of interest are the same...
 94 | 
 95 | ::
 96 | 
 97 |     ls -1 *.shp | sed 's/.shp//g' | xargs -n1 -I % ogr2ogr %-subset.shp %.shp 
 98 |        -sql "SELECT field-one, field-two FROM '%' WHERE field-one='value-of-interest'"
 99 |     
100 | ********************
101 | Raster operations
102 | ********************
103 | 
104 | **Get raster information**
105 | 
106 | ::
107 | 
108 |     gdalinfo input.tif
109 | 
110 | **List raster drivers**
111 | 
112 | ::
113 | 
114 |     gdal_translate --formats
115 | 
116 | **Convert between raster formats**
117 | 
118 | ::
119 | 
120 |     gdal_translate -of "GTiff" input.grd output.tif
121 | 
122 | **Convert 16-bit bands (Int16 or UInt16) to Byte type**
123 | (Useful for Landsat 8 imagery...)
124 | 
125 | ::
126 | 
127 |     gdal_translate -of "GTiff" -co "COMPRESS=LZW" -scale 0 65535 0 255 
128 |         -ot Byte input_uint16.tif output_byte.tif
129 | 
130 | You can change '0' and '65535' to your image's actual min/max values to
131 | preserve more color variation or to apply the scaling to other band
132 | types - find that number with:
133 | 
134 | ::
135 | 
136 |     gdalinfo -mm input.tif | grep Min/Max
137 | 
138 | **Convert a directory of files to a different raster format**
139 | 
140 | ::
141 | 
142 |     ls -1 *.img | sed 's/.img//g' | xargs -n1 -I % gdal_translate 
143 |             -of "GTiff" %.img %.tif
144 | 
145 | **Reproject raster:**
146 | 
147 | ::
148 | 
149 |     gdalwarp -t_srs "EPSG:102003" input.tif output.tif
150 | 
151 | Be sure to add *-r bilinear* if reprojecting elevation data to prevent
152 | funky banding artifacts.
153 | 
154 | **Georeference an unprojected image with known bounding coordinates:**
155 | 
156 | ::
157 | 
158 |     gdal_translate -of GTiff -a_ullr <top_left_lon> <top_left_lat> 
159 |         <bottom_right_lon> <bottom_right_lat> -a_srs EPSG:4269 input.png output.tif
160 | 
161 | **Clip raster by bounding box**
162 | 
163 | ::
164 | 
165 |     gdalwarp -te <x_min> <y_min> <x_max> <y_max> input.tif clipped_output.tif
166 | 
167 | **Clip raster to SHP / NoData for pixels beyond polygon boundary**
168 | 
169 | ::
170 | 
171 |     gdalwarp -dstnodata <nodata_value> -cutline input_polygon.shp 
172 |         input.tif clipped_output.tif
173 | 
174 | **Crop raster dimensions to vector bounding box**
175 | 
176 | ::
177 | 
178 |     gdalwarp -cutline cropper.shp -crop_to_cutline input.tif cropped_output.tif
179 | 
180 | **Merge rasters**
181 | 
182 | ::
183 | 
184 |     gdal_merge.py -o merged.tif input1.tif input2.tif
185 | 
186 | Alternatively,
187 | 
188 | ::
189 | 
190 |     gdalwarp input1.tif input2.tif merged.tif
191 | 
192 | Or, to preserve nodata values:
193 | 
194 | ::
195 | 
196 |     gdalwarp input1.tif input2.tif merged.tif -srcnodata <nodata_value> 
197 |         -dstnodata <merged_nodata_value>
198 | 
199 | **Stack grayscale bands into a georeferenced RGB**
200 | 
201 | Where LC81690372014137LGN00 is a Landsat 8 ID and B4, B3 and B2
202 | correspond to R,G,B bands respectively:
203 | 
204 | ::
205 | 
206 |     gdal_merge.py -co "PHOTOMETRIC=RGB" -separate LC81690372014137LGN00_B{4,3,2}.tif 
207 |         -o LC81690372014137LGN00_rgb.tif
208 | 
209 | **Fix an RGB TIF whose bands don't know they're RGB**
210 | 
211 | ::
212 | 
213 |     gdal_merge.py -co "PHOTOMETRIC=RGB" input.tif -o output_rgb.tif
214 | 
215 | **Export a raster for Google Earth**
216 | 
217 | ::
218 | 
219 |     gdal_translate -of KMLSUPEROVERLAY input.tif output.kmz -co FORMAT=JPEG
220 | 
221 | **Raster calculation (map algebra)**
222 | 
223 | Average two rasters:
224 | 
225 | ::
226 | 
227 |     gdal_calc.py -A input1.tif -B input2.tif --outfile=output.tif --calc="(A+B)/2"
228 | 
229 | Add two rasters:
230 | 
231 | ::
232 | 
233 |     gdal_calc.py -A input1.tif -B input2.tif --outfile=output.tif --calc="A+B"
234 | 
235 | etc.
236 | 
237 | **Create a hillshade from a DEM**
238 | 
239 | ::
240 | 
241 |     gdaldem hillshade -of PNG input.tif hillshade.png
242 | 
243 | Change light direction:
244 | 
245 | ::
246 | 
247 |     gdaldem hillshade -of PNG -az 135 input.tif hillshade_az135.png 
248 | 
249 | Use correct vertical scaling in meters if input is projected in degrees
250 | 
251 | ::
252 | 
253 |     gdaldem hillshade -s 111120 -of PNG input_WGS1984.tif hillshade.png
254 | 
255 | **Apply color ramp to a DEM**
256 | First, create a color-ramp.txt file:
257 | *(Height, Red, Green, Blue)*
258 | 
259 | ::
260 | 
261 |         0 110 220 110
262 |         900 240 250 160
263 |         1300 230 220 170
264 |         1900 220 220 220
265 |         2500 250 250 250
266 | 
267 | Then apply those colors to a DEM:
268 | 
269 | ::
270 | 
271 |     gdaldem color-relief input.tif color_ramp.txt color-relief.tif
272 | 
273 | **Create slope-shading from a DEM**
274 | First, make a slope raster from DEM:
275 | 
276 | ::
277 | 
278 |         gdaldem slope input.tif slope.tif 
279 | 
280 | Second, create a color-slope.txt file:
281 | *(Slope angle, Red, Green, Blue)*
282 | 
283 | ::
284 | 
285 |     0 255 255 255
286 |     90 0 0 0  
287 | 
288 | Finally, color the slope raster based on angles in color-slope.txt:
289 | 
290 | ::
291 | 
292 |     gdaldem color-relief slope.tif color-slope.txt slopeshade.tif
293 | 
294 | **Resample (resize) raster**
295 | 
296 | ::
297 | 
298 |     gdalwarp -ts <width> <height> -r cubicspline dem.tif resampled_dem.tif
299 | 
300 | Entering 0 for either width or height guesses based on current
301 | dimensions.
302 | 
303 | **Burn vector into raster**
304 | 
305 | ::
306 | 
307 |     gdal_rasterize -b 1 -i -burn -32678 -l layername input.shp input.tif
308 | 
309 | **Create contours from DEM**
310 | 
311 | ::
312 | 
313 |     gdal_contour -a elev -i 50 input_dem.tif output_contours.shp
314 | 
315 | **Get values for a specific location in a raster**
316 | 
317 | ::
318 | 
319 |     gdallocationinfo -xml -wgs84 input.tif <lon> <lat>  
320 | 
321 | Other
322 | -----
323 | 
324 | **Convert KML points to CSV (simple)**
325 | 
326 | ::
327 | 
328 |     ogr2ogr -f CSV output.csv input.kmz -lco GEOMETRY=AS_XY
329 | 
330 | **Convert KML to CSV (WKT)**
331 | First list layers in the KML file
332 | 
333 | ::
334 | 
335 |     ogrinfo -so input.kml
336 | 
337 | Convert the desired KML layer to CSV
338 | 
339 | ::
340 | 
341 |     ogr2ogr -f CSV output.csv input.kml -sql "select *,OGR_GEOM_WKT from some_kml_layer"
342 | 
343 | **CSV points to SHP**
344 | *This section needs retooling*
345 | Given input.csv
346 | 
347 | ::
348 | 
349 |     lon_column,lat_column,value
350 |     -81,32,13
351 |     -81,32,14
352 |     -81,32,15
353 | 
354 | Make a .dbf table for ogr2ogr to work with from input.csv
355 | 
356 | ::
357 | 
358 |     ogr2ogr -f "ESRI Shapefile" input.dbf input.csv
359 | 
360 | Use a text editor to create a .vrt file in the same directory as
361 | input.csv and input.dbf. This file holds the parameters for building a
362 | full shapefile based on values in the DBF you just made.
363 | 
364 | ::
365 | 
366 |     <OGRVRTDataSource>
367 |       <OGRVRTLayer name="output_file_name">
368 |         <SrcDataSource relativeToVRT="1">./</SrcDataSource>
369 |         <SrcLayer>input</SrcLayer>
370 |         <GeometryType>wkbPoint</GeometryType>
371 |         <LayerSRS>WGS84</LayerSRS>
372 |         <GeometryField encoding="PointFromColumns" x="lon_column" y="lat_column"/>
373 |       </OGRVRTLayer>
374 |     </OGRVRTDataSource>
375 | 
376 | Create shapefile based on parameters listed in the .vrt
377 | 
378 | ::
379 | 
380 |     mkdir shp
381 |     ogr2ogr -f "ESRI Shapefile" shp/ inputfile.vrt
382 | 
383 | The VRT file can be modified to give a new output shapefile name,
384 | reference a different coordinate system (LayerSRS), or pull coordinates
385 | from different columns.
386 | 
387 | **MODIS operations**
388 | 
389 | First, download relevant .hdf tiles from the MODIS ftp site:
390 | ftp://ladsftp.nascom.nasa.gov/; use the `MODIS sinusoidal
391 | grid <http://www.geohealth.ou.edu/modis_v5/modis.shtml>`__ for
392 | reference.
393 | 
394 | Create a file containing the names of all .hdf files in the directory
395 | 
396 | ::
397 | 
398 |     ls -1 *.hdf > files.txt
399 | 
400 | List MODIS Subdatasets in a given HDF (conf. the `MODIS products
401 | table <https://lpdaac.usgs.gov/products/modis_products_table/>`__)
402 | 
403 | ::
404 | 
405 |     gdalinfo longFileName.hdf | grep SUBDATASET
406 | 
407 | Make TIFs from each file in list; replace 'MOD12Q1:Land\_Cover\_Type\_1'
408 | with desired Subdataset name
409 | 
410 | ::
411 | 
412 |     mkdir output
413 |     cat files.txt | xargs -I % -n1 gdalwarp -of GTiff 
414 |         'HDF4_EOS:EOS_GRID:%:MOD12Q1:Land_Cover_Type_1' output/%.tif
415 | 
416 | Merge all .tifs in output directory into single file
417 | 
418 | ::
419 | 
420 |     cd output
421 |     gdal_merge.py -o Merged_Landcover.tif *.tif
422 | 
423 | 
424 | **BASH functions**
425 | 
426 | *Size Functions*
427 | 
428 | This size function echos the pixel dimensions of a given file in the format expected by gdalwarp.
429 | 
430 | ::
431 | 
432 |     function gdal_size() {
433 |         SIZE=$(gdalinfo $1 |\
434 |             grep 'Size is ' |\
435 |             cut -d\   -f3-4 |\
436 |             sed 's/,//g')
437 |         echo -n "$SIZE"
438 |     }
439 | 
440 | This can be used to easily resample one raster to the dimensions of
441 | another:
442 | 
443 | ::
444 | 
445 |     gdalwarp -ts $(gdal_size bigraster.tif) -r cubicspline 
446 |         smallraster.tif resampled_smallraster.tif
447 | 
448 | *Extent Functions*
449 | 
450 | These extent functions echo the extent of the given file in the
451 | order/format expected by gdal\_translate -projwin. (Originally from
452 | `Linfiniti <http://linfiniti.com/2009/09/clipping-rasters-with-gdal-using-polygons/>`__).
453 | 
454 | ::
455 | 
456 |     function gdal_extent() {
457 |         if [ -z "$1" ]; then 
458 |             echo "Missing arguments. Syntax:"
459 |             echo "  gdal_extent <input_raster>"
460 |             return
461 |         fi
462 |         EXTENT=$(gdalinfo $1 |\
463 |             grep "Upper Left\|Lower Right" |\
464 |             sed "s/Upper Left  //g;s/Lower Right //g;s/).*//g" |\
465 |             tr "\n" " " |\
466 |             sed 's/ *$//g' |\
467 |             tr -d "[(,]")
468 |         echo -n "$EXTENT"
469 |     }
470 | 
471 |     function ogr_extent() {
472 |         if [ -z "$1" ]; then 
473 |             echo "Missing arguments. Syntax:"
474 |             echo "  ogr_extent <input_vector>"
475 |             return
476 |         fi
477 |         EXTENT=$(ogrinfo -al -so $1 |\
478 |             grep Extent |\
479 |             sed 's/Extent: //g' |\
480 |             sed 's/(//g' |\
481 |             sed 's/)//g' |\
482 |             sed 's/ - /, /g')
483 |         EXTENT=`echo $EXTENT | awk -F ',' '{print $1 " " $4 " " $3 " " $2}'`
484 |         echo -n "$EXTENT"
485 |     }
486 | 
487 |     function ogr_layer_extent() {
488 |         if [ -z "$2" ]; then 
489 |             echo "Missing arguments. Syntax:"
490 |             echo "  ogr_extent <input_vector> <layer_name>"
491 |             return
492 |         fi
493 |         EXTENT=$(ogrinfo -so $1 $2 |\
494 |             grep Extent |\
495 |             sed 's/Extent: //g' |\
496 |             sed 's/(//g' |\
497 |             sed 's/)//g' |\
498 |             sed 's/ - /, /g')
499 |         EXTENT=`echo $EXTENT | awk -F ',' '{print $1 " " $4 " " $3 " " $2}'`
500 |         echo -n "$EXTENT"
501 |     }
502 | 
503 | Extents can be passed directly into a gdal\_translate command like so:
504 | 
505 | ::
506 | 
507 |     gdal_translate -projwin $(ogr_extent boundingbox.shp) input.tif clipped_output.tif
508 | 
509 | or
510 | 
511 | ::
512 | 
513 |     gdal_translate -projwin $(gdal_extent target_crop.tif) input.tif clipped_output.tif
514 | 
515 | This can be a useful way to quickly crop one raster to the same extent
516 | as another. Add these to your ~/.bash\_profile file for easy terminal
517 | access.
518 | 
519 | ********************
520 | Sources
521 | ********************
522 | 
523 | http://live.osgeo.org/en/quickstart/gdal_quickstart.html
524 | 
525 | https://github.com/nvkelso/geo-how-to/wiki/OGR-to-reproject,-modify-Shapefiles
526 | 
527 | ftp://ftp.remotesensing.org/gdal/presentations/OpenSource_Weds_Andre_CUGOS.pdf
528 | 
529 | http://developmentseed.org/blog/2009/jul/30/using-open-source-tools-make-elevation-maps-afghanistan-and-pakistan/
530 | 
531 | http://linfiniti.com/2010/12/a-workflow-for-creating-beautiful-relief-shaded-dems-using-gdal/
532 | 
533 | http://linfiniti.com/2009/09/clipping-rasters-with-gdal-using-polygons/
534 | 
535 | http://nautilus.baruch.sc.edu/twiki_dmcc/bin/view/Main/OGR_example
536 | 
537 | http://www.gdal.org/frmt_hdf4.html
538 | 
539 | http://planetflux.adamwilson.us/2010/06/modis-processing-with-r-gdal-and-nco.html
540 | 
541 | http://trac.osgeo.org/gdal/wiki/FAQRaster
542 | 
543 | http://www.mikejcorey.com/wordpress/2011/02/05/tutorial-create-beautiful-hillshade-maps-from-digital-elevation-models-with-gdal-and-mapnik/
544 | 
545 | http://dirkraffel.com/2011/07/05/best-way-to-merge-color-relief-with-shaded-relief-map/
546 | 
547 | http://gfoss.blogspot.com/2008/06/gdal-raster-data-tips-and-tricks.html
548 | 
549 | http://osgeo-org.1560.x6.nabble.com/gdal-dev-Dissolve-shapefile-using-GDAL-OGR-td5036930.html
550 | 
551 | https://www.mapbox.com/tilemill/docs/guides/terrain-data/
552 | 
553 | https://gist.github.com/ashaw/0862ec044c45b9aa3c76
554 | 
555 | https://github.com/gina-alaska/dans-gdal-scripts
556 | 


--------------------------------------------------------------------------------