stud

study spacejunk
Log | Files | Refs | LICENSE

README.md (1311B) - Raw


      1 Countour line generator from LIDAR data
      2 ---------------------------------------
      3 
      4 This accepts two kinds of contour data:
      5 
      6 **2017 variant**: y, x, z, separated by commas:
      7 ```
      8 6062999.75,584000.75,88.07
      9 ```
     10 
     11 Recommended whenever available. It is more dense, gridded (thus much faster),
     12 but not available outside major cities.
     13 
     14 **2009 variant**: x, y, z, separated by one or more spaces:
     15 ```
     16  501991.670  6150000.000  57.689
     17 ```
     18 
     19 2009 is less dense, non-gridded, therefore significantly slower (`gdal_grid`
     20 must be used as an extra step, which is slow). This is less robust, but
     21 available throughout the country.
     22 
     23 Usage
     24 -----
     25 
     26 1. Download contour line zip files to this directory. I.e. `<NAME>.zip` in this
     27    directory must contain exactly one file named `<NAME>.xyz` (compressed).
     28 2. Adjust `BOUNDS` and `VARIANT` in `config.mk`.
     29 3. Run `make -j$(nproc) smooth_<X>.gpkg`. This will output a geo-package with
     30    contour lines every `X` meters. X can be fractional (e.g.
     31    `smooth_2.5.gpkg`).
     32 4. Optional: you may generate a raster image with `layer2img.py`.
     33 
     34 Dependencies for a Linux system:
     35 
     36 - docker
     37 - psql (client only)
     38 - gdal-bin
     39 - unzip
     40 - awk
     41 
     42 Example
     43 -------
     44 
     45 ![Užupis](https://github.com/motiejus/stud/blob/master/contours/example.jpg?raw=true)
     46 
     47 License
     48 -------
     49 
     50 Code in this directory is public domain.