NAME

       pkascii2img - program to create raster image based on ascii file

SYNOPSIS

       pkascii2img [-i input] [-o output] [-ot type] [-of GDALformat] [-co NAME=VALUE] [-dx
                   value] [-dy value] [-ulx value] [-uly value] [-ct filename] [-a_srs
                   EPSG:number] [-d description]

DESCRIPTION

       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

       -i filename, --input filename
              input ASCII file

       -o filename, --output filename
              Output image file

       -ot type, --otype type
              Data  type  for  output  image ({Byte / Int16 / UInt16 / UInt32 / Int32 / Float32 /
              Float64 / CInt16 / CInt32 / CFloat32 / CFloat64}).  Empty string: inherit type from
              input image

       -of GDALformat, --oformat GDALformat
              Output image format (see also gdal_translate(1)).  Empty string: inherit from input
              image

       -co NAME=VALUE, --co NAME=VALUE
              Creation option for output file.  Multiple options can be specified.

       -ulx value, --ulx value
              Upper left x value bounding box (in geocoordinates if georef is true)

       -uly value, --uly value
              Upper left y value bounding box (in geocoordinates if georef is true)

       -dx value, --dx value
              Output resolution in x (in meter)

       -dy value, --dy value
              Output resolution in y (in meter)

       -ct filename, --ct filename
              colour table in ASCII format having 5 columns: id R G B ALFA (0: transparent,  255:
              solid)

       -a_srs EPSG:number, --a_srs EPSG:number
              Override the projection for the output file

       -d description, --description description
              Set image description

       -v, --verbose
              verbose

EXAMPLE

       We create a 5x5 raster dataset containing all 0 values except for its center (value=1)

       cat input.txt

       0 0 0 0 0
       0 0 0 0 0
       0 0 1 0 0
       0 0 0 0 0
       0 0 0 0 0

       We define a pixel size of 25 by 25 m and and a projected in the European projection system
       ETS89/LAEA.  The location of the upper left pixel is also set:

       pkascii2img -i input.txt -o output.tif -of GTiff -a_srs epsg:3035 -dx 25 -dy 25 -ulx 1000000 -uly 1000000

       We check the output GeoTIFF using gdalinfo:

       gdalinfo output.tif

       Driver: GTiff/GeoTIFF
       Files: output.tif
       Size is 5, 5
       Coordinate System is:
       PROJCS["ETRS89 / LAEA Europe",
       GEOGCS["ETRS89",
       DATUM["European_Terrestrial_Reference_System_1989",
       SPHEROID["GRS 1980",6378137,298.2572221010042,
       AUTHORITY["EPSG","7019"]],
       TOWGS84[0,0,0,0,0,0,0],
       AUTHORITY["EPSG","6258"]],
       PRIMEM["Greenwich",0],
       UNIT["degree",0.0174532925199433],
       AUTHORITY["EPSG","4258"]],
       PROJECTION["Lambert_Azimuthal_Equal_Area"],
       PARAMETER["latitude_of_center",52],
       PARAMETER["longitude_of_center",10],
       PARAMETER["false_easting",4321000],
       PARAMETER["false_northing",3210000],
       UNIT["metre",1,
       AUTHORITY["EPSG","9001"]],
       AUTHORITY["EPSG","3035"]]
       Origin = (1000000.000000000000000,1000000.000000000000000)
       Pixel Size = (25.000000000000000,-25.000000000000000)
       Metadata:
       AREA_OR_POINT=Area
       TIFFTAG_DATETIME=2014:11:08 11:33:52
       TIFFTAG_DOCUMENTNAME=output.tif
       TIFFTAG_SOFTWARE=pktools 2.5.4 by Pieter Kempeneers
       Image Structure Metadata:
       INTERLEAVE=BAND
       Corner Coordinates:
       Upper Left ( 1000000.000, 1000000.000) ( 23d13' 9.44"W, 25d30'21.01"N)
       Lower Left ( 1000000.000, 999875.000) ( 23d13' 8.02"W, 25d30'17.24"N)
       Upper Right ( 1000125.000, 1000000.000) ( 23d13' 5.27"W, 25d30'22.72"N)
       Lower Right ( 1000125.000, 999875.000) ( 23d13' 3.85"W, 25d30'18.95"N)
       Center ( 1000062.500, 999937.500) ( 23d13' 6.65"W, 25d30'19.98"N)
       Band 1 Block=5x5 Type=Byte, ColorInterp=Gray
       gdalinfo output.tif
       Driver: GTiff/GeoTIFF
       Files: output.tif
       Size is 5, 5
       Coordinate System is:
       PROJCS["ETRS89 / LAEA Europe",
       GEOGCS["ETRS89",
       DATUM["European_Terrestrial_Reference_System_1989",
       SPHEROID["GRS 1980",6378137,298.2572221010042,
       AUTHORITY["EPSG","7019"]],
       TOWGS84[0,0,0,0,0,0,0],
       AUTHORITY["EPSG","6258"]],
       PRIMEM["Greenwich",0],
       UNIT["degree",0.0174532925199433],
       AUTHORITY["EPSG","4258"]],
       PROJECTION["Lambert_Azimuthal_Equal_Area"],
       PARAMETER["latitude_of_center",52],
       PARAMETER["longitude_of_center",10],
       PARAMETER["false_easting",4321000],
       PARAMETER["false_northing",3210000],
       UNIT["metre",1,
       AUTHORITY["EPSG","9001"]],
       AUTHORITY["EPSG","3035"]]
       Origin = (1000000.000000000000000,1000000.000000000000000)
       Pixel Size = (25.000000000000000,-25.000000000000000)
       Metadata:
       AREA_OR_POINT=Area
       TIFFTAG_DATETIME=2014:11:08 11:33:52
       TIFFTAG_DOCUMENTNAME=output.tif
       TIFFTAG_SOFTWARE=pktools 2.5.4 by Pieter Kempeneers
       Image Structure Metadata:
       INTERLEAVE=BAND
       Corner Coordinates:
       Upper Left ( 1000000.000, 1000000.000) ( 23d13' 9.44"W, 25d30'21.01"N)
       Lower Left ( 1000000.000, 999875.000) ( 23d13' 8.02"W, 25d30'17.24"N)
       Upper Right ( 1000125.000, 1000000.000) ( 23d13' 5.27"W, 25d30'22.72"N)
       Lower Right ( 1000125.000, 999875.000) ( 23d13' 3.85"W, 25d30'18.95"N)
       Center ( 1000062.500, 999937.500) ( 23d13' 6.65"W, 25d30'19.98"N)
       Band 1 Block=5x5 Type=Byte, ColorInterp=Gray

SEE ALSO

       pkascii2ogr(1)

                                           27 June 2023                            pkascii2img(1)