/lactransformer

LAS & Co Transformer is an utility to convert WGS84 (geocentric & geodetic), ETRS89 (geocentric & geodetic), Hungarian EOV, SVY21 (Singapore) projections from/to LiDAR LAS, trajectory CSV, TerraPhoto Image List, Riegl Camera CSV, PEF file formats.

Primary LanguagePythonMozilla Public License 2.0MPL-2.0

lactransformer - LAS & Co Transformer

Build StatusCoverity Scan Build StatusCodacy BadgeMaintainability Scrutinizer Code Quality Build Status

Table of Contents

  1. About
  2. Licensing
  3. Installation
  4. Documentation
  5. Support
  6. Contributing
  7. Donation

About

LAS & Co Transformer is an utility to convert

  • WGS84 (World Geodetic System 1984) Geocentric coordinate system
  • WGS84 (World Geodetic System 1984) Geodetic coordinate system
  • WGS84 (World Geodetic System 1984) Pseudo-Mercator -- Spherical Mercator, Google Maps, OpenStreetMap, Bing, ArcGIS, ESRI coordinate system
  • ETRS89 (European Terrestrial Reference System 1989) Geocentric coordinate system
  • ETRS89 (European Terrestrial Reference System 1989) Geodetic coordinate system
  • Hungarian EOV (Egységes Országos Vetület) Projected 2014 coordinate system
  • Hungarian EOV (Egységes Országos Vetület) Projected 2009 coordinate system
  • SVY21 (Singapore) Projected coordinate system

in following formats:

  • LiDAR LAS files
  • Trajectory CSV file
  • TerraPhoto Image List file
  • Riegl Camera CSV file
  • PEF file
  • RTK CSV format (strtxt)

Since version 0.3.0.0 LAS & Co Transformer uses at least Python version 3.5.

Supported projections

WGS84 (EPSG:4326) projection : http://epsg.io/4326/

WGS84geo (EPSG:4978) projection : http://epsg.io/4978/

WGS84PM (EPSG:3857) projection : http://epsg.io/3857/

EOV (EPSG:23700) projection: http://epsg.io/23700/

ETRS89 (EPSG:4258) projection: http://epsg.io/4258/

ETRS89geo (EPSG:4936) projection: http://epsg.io/4936/

SVY21 (EPSG:3414) projection: http://epsg.io/3414

EOV correction grid

Original download: http://www.agt.bme.hu/on_line/etrs2eov/etrs2eov_doc.html

Created by: Zoltán Siki siki@agt.bme.hu and Bence Takács bence@agt.bme.hu

Github page: https://github.com/OSGeoLabBp/eov2etrs

Modules

pyproj - https://pypi.python.org/pypi/pyproj/

laspy - https://pypi.python.org/pypi/laspy/

numpy - https://pypi.python.org/pypi/numpy/

pandas - https://pypi.python.org/pypi/pandas/

Licensing

The lactransformer application and documantations are licensed under the terms of the Mozilla Public License 2.0, you will find a copy of this license in the LICENSE file included in the source package.

Installation

Linux (Debian/Ubuntu/Linux Mint)

Install Python 2.7

sudo apt-get install python2.7 python-numpy python-pandas

Install numpy, pandas, pyproj, laspy

sudo pip install -r requirements.txt

Windows

Install Python 2.7

We prefer 64 bit AMD64 version.

https://www.python.org/downloads/

Install pip

Installation manual: https://pip.pypa.io/en/latest/installing.html

Download: https://bootstrap.pypa.io/get-pip.py

python get-pip.py

Install Numpy

Download:

http://www.lfd.uci.edu/~gohlke/pythonlibs/#numpy

One of these files:

numpy-1.13.3+mkl-cp27-cp27m-win_amd64.whl for 64 bit version

https://download.lfd.uci.edu/pythonlibs/yjwkc9i2/numpy-1.13.3+mkl-cp27-cp27m-win_amd64.whl

numpy-1.13.3+mkl-cp27-cp27m-win32.whl for 32 bit version

https://download.lfd.uci.edu/pythonlibs/yjwkc9i2/numpy-1.13.3+mkl-cp27-cp27m-win32.whl

And install it:

C:\Python27\Scripts\pip.exe install "numpy-1.13.3+mkl-cp27-cp27m-win32.whl"

Install Pandas

Download:

http://www.lfd.uci.edu/~gohlke/pythonlibs/#pandas

One of these files:

pandas-0.21.1-cp27-cp27m-win_amd64.whl for 64 bit version

https://download.lfd.uci.edu/pythonlibs/yjwkc9i2/pandas-0.21.1-cp27-cp27m-win_amd64.whl

pandas-0.21.1-cp27-cp27m-win32.whl for 32 bit version

https://download.lfd.uci.edu/pythonlibs/yjwkc9i2/pandas-0.21.1-cp27-cp27m-win32.whl

And install it:

C:\Python27\Scripts\pip.exe install "pandas-0.21.1-cp27-cp27m-win32.whl"

Install pyproj

Download:

http://www.lfd.uci.edu/~gohlke/pythonlibs/#pyproj

One of these files:

pyproj-1.9.5.1-cp27-cp27m-win_amd64.whl for 64 bit version

http://www.lfd.uci.edu/%7Egohlke/pythonlibs/6kbpejrn/pyproj-1.9.5.1-cp27-cp27m-win_amd64.whl

pyproj‑1.9.5.1‑cp27‑none‑win32.whl for 32 bit version

http://www.lfd.uci.edu/%7Egohlke/pythonlibs/6kbpejrn/pyproj-1.9.5.1-cp27-cp27m-win32.whl

And install it:

C:\Python27\Scripts\pip.exe install "pyproj-1.9.5.1-cp27-none-win_amd64.whl"

Install laspy

Download: https://github.com/laspy/laspy/archive/1.5.1.zip

Unzip 1.5.1.zip file

Enter to the folder of laspy-1.5.1

And build it:

python setup.py build

Then install it:

python setup.py install

Documentation

One LAS file

Convert LAS file from WGS84 to EOV:

lactransformer.py -i wgs84.las -o eov.las

A directory of LAS files

Convert all LAS files in a directory from WGS84 to EOV using 2 cores:

lactransformer.py -i wgs84dir/ -o eovdir/ -cores 2

Converting LAZ file is currently not supported.

One Trajectory (CSV) text file

Convert Trajectory (CSV) text file from WGS84 to EOV:

lactransformer.py -i wgs84_trj.txt -o eov_trj.txt -input_format=txt

A directory of Trajectory (CSV) text files

Convert all Trajectory (CSV) text files in a directory from WGS84 to EOV using 2 cores:

lactransformer.py -i wgs84dir_trj/ -o eovdir_trj/ -cores 2 -input_format=txt

Support

If you have any question, do not hesitate and drop me a line. If you found a bug, or have a feature request, you can fill an issue.

Contributing

There are many ways to contribute to lactransformer -- whether it be sending patches, testing, reporting bugs, or reviewing and updating the documentation. Every contribution is appreciated!

Please continue reading in the contributing chapter.

Fork me on Github

SSH:

git@github.com:KAMI911/lactransformer.git

HTTPS:

https://github.com/KAMI911/lactransformer.git

Add a new remote upstream with this repository as value.

git remote add upstream https://github.com/KAMI911/lactransformer.git

You can pull updates to your fork's master branch:

git fetch --all
git pull upstream HEAD

Donation

If you find this useful, please consider a donation:

paypal