/GeodesiCL

GeodesiCL package

Primary LanguageR

GeodesiCL: A little journey into Geometric Geodesy.


License: GPL v3 CRAN_Status_Badge R-CMD-check Project Status: Active ??? The project has reached a stable, usable state and is being actively developed. Say Thanks!

Attention: We are ready to go!!

To begin with

This package was created to introduce topographical and related engineers in the area of Topography and Geodesy as a basic introduction to Geometric Geodesy applying the necessary basic formulas.

This was a project created between Diego Alarcón and Karla Riquelme seeing the need to introduce the new generation of professionals in the learning of software language and in turn present free software.


Installation

Install system dependencies

Please make sure that the GDAL libraries are installed on your system:

  • Windows: use the OSGeo4W installer.
  • Ubuntu: sudo apt install gdal-bin libgdal-dev
  • MacOS: brew install gdal --HEAD or brew install gdal

For more information on GDAL installation Click here!

We currently have two ways to install this package, as it is not yet finalized for posting to CRAN Project.

First option

After we already have the system dependencies, to use this package you should install R & RStudio. Next, you need to install the devtools package in order to start with the installation of the GeodesiCL package, then just copy and paste the following command into the RStudio console:

install.packages("devtools")
devtools::install_github("diegoalarc/GeodesiCL")

Second option

If you already have experience using R & RStudio, you could just copy the following command:

install.packages("GeodesiCL")

Inside the package

Check the PDF manual here.

Quick overview

The Ellipsoids within the package are as follows:

Number Description Ellipsoids a 1/f
1 Provisional Southamerican 56 PSAD56 6378388 297
2 South American Datum 69 SAD69 6378160 298.25
3 MERIT 1983 MERIT 6378137 298.257
4 Soviet Geodetic System 85 SGS85 6378136 298.257
5 GRS 1980(IUGG 1980) GRS80 6378137 298.257222101
6 IAU 1976 IAU76 6378140 298.257
7 Airy 1830 airy 6377563.396 299.3249646
8 Appl. Physics. 1965 APL4.9 6378137 298.25
9 Naval Weapons Lab. 1965 NWL9D 6378145 298.25
10 Modified Airy mod_airy 6377340.189 6356034.446
11 Andrae 1876 (Den. Iclnd.) andrae 6377104.43 300
12 Andrae 1876 (Denmark Iceland) danish 6377019.2563 300
13 Australian Natl & S. Amer. 1969 aust_SA 6378160 298.25
14 GRS 67(IUGG 1967) GRS67 6378160 298.247167427
15 GSK-2011 GSK2011 6378136.5 298.2564151
16 Bessel 1841 bessel 6377397.155 299.1528128
17 Bessel 1841 (Namibia) bess_nam 6377483.865 299.1528128
18 Clarke 1866 clrk66 6378206.4 6356583.8
19 Clarke 1880 mod. clrk80 6378249.145 293.4663
20 Clarke 1880 (IGN). clrk80ign 6378249.2 293.466021293627
21 Comm. des Poids et Mesures 1799 CPM 6375738.7 334.29
22 Delambre 1810 (Belgium) delmbr 6376428 311.5
23 Engelis 1985 engelis 6378136.05 298.2566
24 Everest 1830 evrst30 6377276.345 300.8017
25 Everest 1948 evrst48 6377304.063 300.8017
26 Everest 1956 evrst56 6377301.243 300.8017
27 Everest 1969 evrst69 6377295.664 300.8017
28 Everest (Sabah & Sarawak) evrstSS 6377298.556 300.8017
29 Fischer (Mercury Datum) 1960 fschr60 6378166 298.3
30 Modified Fischer 1960 fschr60m 6378155 298.3
31 Fischer 1968 fschr68 6378150 298.3
32 Helmert 1906 helmert 6378200 298.3
33 Hough hough 6378270 297
34 International 1909 (Hayford) intl 6378388 297
35 Krassovsky 1942 krass 6378245 298.3
36 Kaula 1961 kaula 6378163 298.24
37 Lerch 1979 lerch 6378139 298.257
38 Maupertius 1738 mprts 6397300 191
39 New International 1967 new_intl 6378157.5 6356772.2
40 Plessis 1817 (France) plessis 6376523 6355863
41 PZ-90 PZ90 6378136 298.25784
42 Southeast Asia SEasia 6378155 6356773.3205
43 Walbeck walbeck 6376896 6355834.8467
44 WGS 60 WGS60 6378165 298.3
45 WGS 66 WGS66 6378145 298.25
46 WGS 72 WGS72 6378135 298.26
47 WGS 84 WGS84 6378137 298.257223563
48 Normal Sphere (r=6370997) sphere 6370997 6370997

Functions

Here you can see the functions contained in the package. Is it possible to read its description by copying to the console ?function or if you want to see an example just using example(function) like the following:

Check out each example, since most functions work with data.frame that has a specific order for its data.

arch: Rope reduction to elliptical arch.

?arch

example(arch)

cartesian: To convert from Geographic coordinate to Cartesian coordinate.

?cartesian

example(cartesian)

E2: To calculate 1-e^2.

?E2

example(E2)

E3: To calculate 1-e^2*sen(lat)^2.

?E3

example(E3)

geodesic: To convert from Cartesian coordinate to Geographic coordinate.

?geodesic

example(geodesic)

geodis: Reduction of the horizontal distance to the Ellipsoid.

?geodis

example(geodis)

LongLatToUTM: To convert from Geographic coordinate to UTM coordinate.

?LongLatToUTM

example(LongLatToUTM)

M: To calculate the value of M.

?M

example(M)

N: To calculate the value of N.

?N

example(N)

PlotLongLat: To plot using Geographic coordinate.

?PlotLongLat

example(PlotLongLat)

radians: To convert separated data in Degrees Minutes and Seconds to Radians.

?radians

example(radians)

rSL: To calculate the value of r, S and L.

?rSL

example(rSL)

scalfactor: To calculate scale factor calculation.

?scalfactor

example(scalfactor)

sexagesimal: To convert separated data in Degrees Minutes and Seconds to Decimal degrees.

?sexagesimal

example(sexagesimal)

TO_TM: To convert from Geographic coordinate to TM.

?TO_TM

example(TO_TM)

UTMtoLongLat: To convert from UTM to Geographic coordinate.

?UTMtoLongLat

example(UTMtoLongLat)

UTM_zone_hemisphere: To find the zone hemisphere from Longitude and Latitude the UTM zone.

?UTM_zone_hemisphere

example(UTM_zone_hemisphere)

Interesting fact

As entertaining fact, the name of the package is because geodesy is written geodesia in Spanish and CL represents the acronym of my country Chile but strangely you can see an A writing GeodesiA in Spanish (lol).


Contribution

We do hope you enjoy the package and give us your feedback in order to make this package better, easy and accurate as possible! Open an issue to start a discussion:


GNU General Public License v3.0 - Copyright (C)

This script was made for testing purposes and may be used and modified in the future by those who see fit.


Package Information

Contributors Forks Stargazers


Package stats

Github All Releases Codecov test coverage