Merge pull request #892 from geographika/gdal-updates

GDAL Quickstart and Overview updates

Author: cvvergara

doc/overview/gdal_overview.rst

@@ -35,8 +35,8 @@ Core Features
 * Command-line utilities for data translation, image warping, subsetting, and various other common tasks
 * Highly efficient raster data access, taking advantage of tiling and overviews
 * Support for large files - larger than 4GB
-* Library access from Python, Java, C#, Ruby, VB6 and Perl
-* Coordinate system engine built on PROJ.4 and OGC Well Known Text coordinate system descriptions
+* Library access from Python, Java, and C#
+* Coordinate system engine built on PROJ and OGC Well Known Text coordinate system descriptions
 
 Popular Supported Formats
 --------------------------------------------------------------------------------
@@ -45,8 +45,8 @@ GDAL supports over 140 raster formats, and OGR over 80 vector formats.
 
 These include:
 
-* **Raster:** GeoTIFF, Erdas Imagine, SDTS, ESRI Grids, ECW, MrSID, JPEG2000, DTED, NITF, GeoPackage and more ...
-* **Vector:** GeoPackage, ESRI Shapefile, GML, GeoJSON, AutoCAD DWG, MapInfo (tab and mid/mif), ESRI Coverages, ESRI Personal Geodatabase, DGN, PostGIS, Oracle Spatial, and more ...
+* **Raster:** GeoTIFF / COG, HDF, NetCDF, GeoPackage, JPEG2000, ECW, ENVI, KEA, MrSID, DTED, NITF and more ...
+* **Vector:** GeoPackage, ESRI Shapefile, GeoJSON, PostGIS, (Geo)Parquet, ESRI File Geodatabase, FlatGeobuf, GML, AutoCAD DWG, MapInfo, DGN, Oracle Spatial, and more ...
 
 Implemented Standards
 --------------------------------------------------------------------------------
@@ -64,7 +64,7 @@ Details
 
 **Supported Platforms:** Windows, Linux, Mac
 
-**API Interfaces:** C, C++, Python, Java, C#, Ruby, VB6 and Perl
+**API Interfaces:** C, C++, Python, Java, C#
 
 **Support:** https://lists.osgeo.org/mailman/listinfo/gdal-dev, https://www.osgeo.org/service-providers/
 

doc/quickstart/gdal_quickstart.rst

@@ -56,7 +56,8 @@ directory.
 You will then find a NaturalEarth Raster file and a .tfw World-file at:
 ::
 
- ls /home/user/gdal_natural_earth/HYP_50M_SR_W.*
+ cd /home/user/gdal_natural_earth
+ ls HYP_50M_SR_W.*
 
 
 .. tip:: Open the file with a Desktop GIS like QGIS, and have a look.
@@ -68,28 +69,35 @@ Get information about the raster data with gdalinfo
       gdalinfo HYP_50M_SR_W.tif
 	Driver: GTiff/GeoTIFF
 	Files: HYP_50M_SR_W.tif
-	       HYP_50M_SR_W.tfw
 	Size is 10800, 5400
-	Coordinate System is `'
+	Coordinate System is:
+	GEOGCRS["WGS 84",
+	    ENSEMBLE["World Geodetic System 1984 ensemble",
+      ...
 	Origin = (-179.999999999999972,90.000000000000000)
 	Pixel Size = (0.033333333333330,-0.033333333333330)
 	Metadata:
-	  TIFFTAG_SOFTWARE=Adobe Photoshop CS3 Macintosh
-	  TIFFTAG_DATETIME=2009:09:19 10:13:17
+	  TIFFTAG_SOFTWARE=Adobe Photoshop CS5 Macintosh
+	  TIFFTAG_DATETIME=2012:07:16 09:16:14
 	  TIFFTAG_XRESOLUTION=342.85699
 	  TIFFTAG_YRESOLUTION=342.85699
 	  TIFFTAG_RESOLUTIONUNIT=2 (pixels/inch)
+	  AREA_OR_POINT=Area
 	Image Structure Metadata:
+	  SOURCE_COLOR_SPACE=YCbCr
+	  COMPRESSION=YCbCr JPEG
 	  INTERLEAVE=PIXEL
+	  JPEG_QUALITY=90
+	  JPEGTABLESMODE=3
 	Corner Coordinates:
-	Upper Left  (-180.0000000,  90.0000000)
-	Lower Left  (-180.0000000, -90.0000000)
-	Upper Right ( 180.0000000,  90.0000000)
-	Lower Right ( 180.0000000, -90.0000000)
-	Center      (  -0.0000000,   0.0000000)
-	Band 1 Block=10800x1 Type=Byte, ColorInterp=Red
-	Band 2 Block=10800x1 Type=Byte, ColorInterp=Green
-	Band 3 Block=10800x1 Type=Byte, ColorInterp=Blue
+	Upper Left  (-180.0000000,  90.0000000) (180d 0' 0.00"W, 90d 0' 0.00"N)
+	Lower Left  (-180.0000000, -90.0000000) (180d 0' 0.00"W, 90d 0' 0.00"S)
+	Upper Right ( 180.0000000,  90.0000000) (180d 0' 0.00"E, 90d 0' 0.00"N)
+	Lower Right ( 180.0000000, -90.0000000) (180d 0' 0.00"E, 90d 0' 0.00"S)
+	Center      (  -0.0000000,   0.0000000) (  0d 0' 0.00"W,  0d 0' 0.00"N)
+	Band 1 Block=256x256 Type=Byte, ColorInterp=Red
+	Band 2 Block=256x256 Type=Byte, ColorInterp=Green
+	Band 3 Block=256x256 Type=Byte, ColorInterp=Blue
 
 Note:
   * Driver is "GTiff/GeoTIFF"
@@ -103,19 +111,21 @@ Note:
 Simple format translation
 =========================
 
-First get to know your drivers. The `--formats` commandline switch of
+First get to know your drivers. The `--formats` command line switch of
 gdal_translate can be used to see a list of available format drivers.
 
-Each format reports if it is
-  * read only (ro),
-  * read/write (rw) or
-  * read/write/update (rw+).
+Each format reports if it supports the following features:
+  * read only (ro)
+  * read/write (rw)
+  * read/write/update (rw+)
+  * supports virtual file systems (v)
+  * supports subdatasets (s)
 
 ::
 
  gdal_translate --formats
 
-The `--format` commandline switch can be used to query details about a
+The `--format` command line switch can be used to query details about a
 particular driver, including creation options, and permitted data types.
 
 ::
@@ -193,31 +203,29 @@ will learn more about ogrinfo later in this tutorial)
       using driver `ESRI Shapefile' successful.
 
   Layer name: index_natural_earth
+  Metadata:
+    DBF_DATE_LAST_UPDATE=2025-05-13
   Geometry: Polygon
   Feature Count: 2
   Extent: (-180.000000, -90.000000) - (180.000000, 90.000000)
-  Layer SRS WKT: (unknown)
-  location: String (255.0)
+  Layer SRS WKT:
+  GEOGCRS["WGS 84",
+      ...
+  location: String (254.0)
   OGRFeature(index_natural_earth):0
-    location (String) = east.tif
-    POLYGON ((-0.00000000001796 90.0,179.999999999964047 90.0,179.999999999964047 -89.999999999982009,-0.00000000001796 -89.999999999982009,-0.00000000001796 90.0))
+    location (String) = west.tif
+    POLYGON ((-180 90.0,-0.000000000017963 90.0,-0.000000000017963 -89.999999999982,-180 -89.999999999982,-180 90.0))
 
   OGRFeature(index_natural_earth):1
-    location (String) = west.tif
-    POLYGON ((-179.999999999999972 90.0,-0.00000000001796 90.0,-0.00000000001796 -89.999999999982009,-179.999999999999972 -89.999999999982009,-179.999999999999972 90.0))
+    location (String) = east.tif
+    POLYGON ((-0.000000000017963 90.0,179.999999999964 90.0,179.999999999964 -89.999999999982,-0.000000000017963 -89.999999999982,-0.000000000017963 90.0))
 
 
 Reprojecting
 ============
 
 For this process we assume that HYP_50M_SR_W.tif has been properly
-created with bounds. As we saw before with gdainfo no coordinate system
-was set. So we assign WGS84 as coordinate system to the image in the
-first step.
-
-::
-
-     gdal_translate -a_srs WGS84 HYP_50M_SR_W.tif HYP_50M_SR_W_4326.tif
+created with bounds.
 
 The gdalwarp command can be used to reproject images. Here we reproject
 the WGS84 geographic image to the Mercator projection:
@@ -285,18 +293,19 @@ Get information about the vector data with ogrinfo
   ogrinfo -ro /home/user/gdal_natural_earth
   INFO: Open of `/home/user/gdal_natural_earth'
         using driver `ESRI Shapefile' successful.
-    1: ne_10m_populated_places (3D Point)
-    2: ne_10m_geography_regions_polys (3D Polygon)
-    3: ne_10m_admin_1_states_provinces_shp (3D Polygon)
-    4: ne_10m_urban_areas (3D Polygon)
-    5: ne_10m_geography_marine_polys (3D Polygon)
-    6: ne_10m_land (3D Polygon)
-    7: ne_10m_geography_regions_elevation_points (3D Point)
-    8: ne_10m_admin_0_countries (3D Polygon)
-    9: ne_10m_rivers_lake_centerlines (3D Line String)
-    10: ne_10m_lakes (3D Polygon)
-    11: ne_10m_geography_regions_points (3D Point)
-    12: ne_10m_ocean (3D Polygon)
+  1: ne_10m_geography_regions_polys (Polygon)
+  2: ne_10m_populated_places (Point)
+  3: ne_10m_urban_areas (Polygon)
+  4: ne_10m_geography_marine_polys (Polygon)
+  5: ne_10m_admin_1_states_provinces_shp (Polygon)
+  6: ne_10m_admin_0_countries (Polygon)
+  7: ne_10m_ocean (Polygon)
+  8: ne_10m_rivers_lake_centerlines (Line String)
+  9: ne_10m_land (Polygon)
+  10: index_natural_earth (Polygon)
+  11: ne_10m_geography_regions_elevation_points (Point)
+  12: ne_10m_geography_regions_points (Point)
+  13: ne_10m_lakes (Polygon)
 
 
 Get a summary about your data with ogrinfo together with `-so`.
@@ -308,15 +317,15 @@ Get a summary about your data with ogrinfo together with `-so`.
 	      using driver `ESRI Shapefile' successful.
 
 	Layer name: ne_10m_admin_0_countries
-	Geometry: 3D Polygon
+	Metadata:
+	  DBF_DATE_LAST_UPDATE=2012-11-05
+	Geometry: Polygon
 	Feature Count: 254
 	Extent: (-180.000000, -90.000000) - (180.000000, 83.634101)
 	Layer SRS WKT:
-	GEOGCS["GCS_WGS_1984",
-	    DATUM["WGS_1984",
-		SPHEROID["WGS_84",6378137.0,298.257223563]],
-	    PRIMEM["Greenwich",0.0],
-	    UNIT["Degree",0.0174532925199433]]
+	GEOGCRS["WGS 84",
+	    DATUM["World Geodetic System 1984",
+	...
 	scalerank: Integer (4.0)
 	featurecla: String (30.0)
 	labelrank: Real (16.6)

locale/en/LC_MESSAGES/overview/gdal_overview.po

@@ -8,14 +8,14 @@ msgid ""
 msgstr ""
 "Project-Id-Version: OSGeoLive 13.0\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-09-26 14:03+0000\n"
+"POT-Creation-Date: 2025-05-13 22:44+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.16.0\n"
+"Generated-By: Babel 2.17.0\n"
 
 #: ../../build/doc/overview/gdal_overview.rst:18
 msgid "GDAL/OGR"
@@ -72,13 +72,13 @@ msgid "Support for large files - larger than 4GB"
 msgstr ""
 
 #: ../../build/doc/overview/gdal_overview.rst:48
-msgid "Library access from Python, Java, C#, Ruby, VB6 and Perl"
+msgid "Library access from Python, Java, and C#"
 msgstr ""
 
 #: ../../build/doc/overview/gdal_overview.rst:49
 msgid ""
-"Coordinate system engine built on PROJ.4 and OGC Well Known Text "
-"coordinate system descriptions"
+"Coordinate system engine built on PROJ and OGC Well Known Text coordinate"
+" system descriptions"
 msgstr ""
 
 #: ../../build/doc/overview/gdal_overview.rst:52
@@ -95,15 +95,15 @@ msgstr ""
 
 #: ../../build/doc/overview/gdal_overview.rst:58
 msgid ""
-"**Raster:** GeoTIFF, Erdas Imagine, SDTS, ESRI Grids, ECW, MrSID, "
-"JPEG2000, DTED, NITF, GeoPackage and more ..."
+"**Raster:** GeoTIFF / COG, HDF, NetCDF, GeoPackage, JPEG2000, ECW, ENVI, "
+"KEA, MrSID, DTED, NITF and more ..."
 msgstr ""
 
 #: ../../build/doc/overview/gdal_overview.rst:59
 msgid ""
-"**Vector:** GeoPackage, ESRI Shapefile, GML, GeoJSON, AutoCAD DWG, "
-"MapInfo (tab and mid/mif), ESRI Coverages, ESRI Personal Geodatabase, "
-"DGN, PostGIS, Oracle Spatial, and more ..."
+"**Vector:** GeoPackage, ESRI Shapefile, GeoJSON, PostGIS, (Geo)Parquet, "
+"ESRI File Geodatabase, FlatGeobuf, GML, AutoCAD DWG, MapInfo, DGN, Oracle"
+" Spatial, and more ..."
 msgstr ""
 
 #: ../../build/doc/overview/gdal_overview.rst:62
@@ -139,7 +139,7 @@ msgid "**Supported Platforms:** Windows, Linux, Mac"
 msgstr ""
 
 #: ../../build/doc/overview/gdal_overview.rst:77
-msgid "**API Interfaces:** C, C++, Python, Java, C#, Ruby, VB6 and Perl"
+msgid "**API Interfaces:** C, C++, Python, Java, C#"
 msgstr ""
 
 #: ../../build/doc/overview/gdal_overview.rst:79
@@ -156,11 +156,11 @@ msgstr ""
 msgid ":doc:`Quickstart documentation <../quickstart/gdal_quickstart>`"
 msgstr ""
 
-#: ../../build/doc/<rst_epilog>:13
+#: ../../build/doc/<rst_epilog>:11
 msgid "vmdk"
 msgstr ""
 
-#: ../../build/doc/<rst_epilog>:16
+#: ../../build/doc/<rst_epilog>:14
 msgid "nologo"
 msgstr ""