gdal icon indicating copy to clipboard operation
gdal copied to clipboard

Doc: Add a Downloading Geoparquet Data from Overture Maps tutorial

Open geographika opened this issue 6 months ago • 5 comments

A first attempt at a new tutorial.

Highlights:

  • shows the new CLI and traditional tools side-by-side to help users migrate workflows
  • tested on both Linux and Windows (using PowerShell)
  • show various issues and errors I encountered rather than the error-free commands I eventually ended up with. Hopefully this will help people who run into the same issues, and also with web searches.
  • If enough similar tutorials are created they could form a new workshop for a future FOSS4G.

I ran into a couple of issues using Conda:

  • https://github.com/conda-forge/gdal-feedstock/issues/1099 - I needed to add conda config --set solver classic when testing on a Linux Docker image
  • https://github.com/conda-forge/gdal-feedstock/issues/1100 - I'm not sure if this is an issue that can be resolved, or just needs to be documented for Windows.

@dbaston @rouault - interested in your feedback on the layout / approach, and GDAL commands used.

geographika avatar Jun 12 '25 14:06 geographika

Looks awesome!

https://gdal--12561.org.readthedocs.build/en/12561/tutorials/vector_geoparquet_tut.html

hobu avatar Jun 12 '25 15:06 hobu

I'd also remove the conda config --set solver classic or set it to the mamba solver. The classic one can take a long time

msmitherdc avatar Jun 12 '25 20:06 msmitherdc

I'd also remove the conda config --set solver classic or set it to the mamba solver. The classic one can take a long time

@msmitherdc this is hopefully something that can be removed, but unfortunately it is not working for me without that on Docker (on Windows). These commands never complete:

docker run -t -i continuumio/miniconda3 /bin/bash
conda install --yes -c conda-forge gdal

Is this working for anyone else?

I've tried the usual steps to try and fix this (WSL updated to latest version, Docker Desktop updated, reboot, run as admin) but with no success. See https://github.com/conda-forge/gdal-feedstock/issues/1099 for further details.

geographika avatar Jun 13 '25 10:06 geographika

@geographika maybe try using condaforge/mambaforge:latest instead of miniconda? Or perhaps ghcr.io/prefix-dev/pixi:latest?

msmitherdc avatar Jun 13 '25 10:06 msmitherdc

@msmitherdc the following works fine:

docker run -t -i condaforge/mambaforge:latest /bin/bash
conda install --yes -c conda-forge gdal

I'll remove conda config --set solver classic from the docs, and hope Linux users have more luck than I did with installing Conda! https://www.anaconda.com/docs/getting-started/miniconda/install#linux also failed for me (again on a Docker using ghcr.io/prefix-dev/pixi:latest).

geographika avatar Jun 13 '25 12:06 geographika