| pktools 2.6.7 Processing Kernel for geospatial data

pkascii2img

program to create raster image based on ascii file

## SYNOPSIS

`Usage: pkascii2img -i input.txt -o output`

``

`Options: [-ot type] [-of GDALformat] [-co NAME=VALUE]* [-dx value] [-dy value] [-ulx value] [-uly value] [-ct filename] [-a_srs EPSG:number] [-d description]`

``

# Description

The utility pkascii2img creates a raster dataset from an ASCII textfile. The textfile is in matrix format (rows and columns). The dimensions in x and y are defined by the number of columns and rows respectively. The georeferencing can be defined by providing the options for cell size (-dx -dy), upper left position (-ulx -uly) and the projection (-a_srs). Some dataset formats can also store a description (-d) and a color table (-ct).

# Options

- use either `-short` or `--long` options (both `--long=value` and `--long value` are supported)
- short option `-h` shows basic options only, long option `--help` shows all options

  short | long | type | default | description
  --- | --- | --- | --- | ---
  i | input | std::string |  | input ASCII file
  o | output | std::string |  | Output image file
  ot | otype | std::string | Byte | Data type for output image ({Byte/Int16/UInt16/UInt32/Int32/Float32/Float64/CInt16/CInt32/CFloat32/CFloat64}). Empty string: inherit type from input image
  of | oformat | std::string | GTiff | image type string (see also gdal_translate)
  co | co | std::string |  | Creation option for output file. Multiple options can be specified.
  ulx | ulx | double | 0 | Upper left x value bounding box (in geocoordinates if georef is true)
  uly | uly | double | 0 | Upper left y value bounding box (in geocoordinates if georef is true)
  dx | dx | double |  | Output resolution in x (in meter)
  dy | dy | double |  | Output resolution in y (in meter)
  ct | ct | std::string |  | color table (file with 5 columns: id R G B ALFA (0: transparent, 255: solid)
  a_srs | a_srs | std::string |  | Override the projection for the output file
  d | description | std::string |  | Set image description

Usage: pkascii2img -i input.txt -o output

# Examples

Some examples how to use pkascii2img can be found here