From be3791ffd5e802d5a3d38fa08f5ed24715b73c7c Mon Sep 17 00:00:00 2001 From: Kristian Evers Date: Wed, 28 Feb 2018 22:37:13 +0100 Subject: Move 'Coordinate operations' to top level of docs [skip ci] --- docs/source/index.rst | 1 + docs/source/operations/conversions/axisswap.rst | 39 +++ docs/source/operations/conversions/cart.rst | 24 ++ docs/source/operations/conversions/index.rst | 18 + docs/source/operations/conversions/latlon.rst | 6 + docs/source/operations/conversions/lonlat.rst | 6 + docs/source/operations/conversions/unitconvert.rst | 112 ++++++ docs/source/operations/index.rst | 22 ++ docs/source/operations/pipeline.rst | 98 ++++++ docs/source/operations/projections/aeqd.rst | 22 ++ docs/source/operations/projections/airy.rst | 26 ++ docs/source/operations/projections/aitoff.rst | 10 + docs/source/operations/projections/alsk.rst | 10 + docs/source/operations/projections/apian.rst | 10 + docs/source/operations/projections/august.rst | 10 + docs/source/operations/projections/bacon.rst | 10 + docs/source/operations/projections/bipc.rst | 10 + docs/source/operations/projections/boggs.rst | 10 + docs/source/operations/projections/bonne.rst | 10 + docs/source/operations/projections/calcofi.rst | 95 +++++ docs/source/operations/projections/cass.rst | 145 ++++++++ docs/source/operations/projections/cc.rst | 10 + docs/source/operations/projections/ccon.rst | 127 +++++++ docs/source/operations/projections/cea.rst | 10 + docs/source/operations/projections/chamb.rst | 10 + docs/source/operations/projections/collg.rst | 10 + docs/source/operations/projections/crast.rst | 10 + docs/source/operations/projections/denoy.rst | 10 + docs/source/operations/projections/eck1.rst | 18 + docs/source/operations/projections/eck2.rst | 10 + docs/source/operations/projections/eck3.rst | 10 + docs/source/operations/projections/eck4.rst | 19 + docs/source/operations/projections/eck5.rst | 10 + docs/source/operations/projections/eck6.rst | 10 + docs/source/operations/projections/eqc.rst | 110 ++++++ docs/source/operations/projections/eqdc.rst | 10 + docs/source/operations/projections/etmerc.rst | 10 + docs/source/operations/projections/euler.rst | 10 + docs/source/operations/projections/fahey.rst | 10 + docs/source/operations/projections/fouc.rst | 10 + docs/source/operations/projections/fouc_s.rst | 25 ++ docs/source/operations/projections/gall.rst | 84 +++++ docs/source/operations/projections/geos.rst | 72 ++++ docs/source/operations/projections/gins8.rst | 10 + docs/source/operations/projections/gn_sinu.rst | 10 + docs/source/operations/projections/gnom.rst | 10 + docs/source/operations/projections/goode.rst | 10 + docs/source/operations/projections/gs48.rst | 10 + docs/source/operations/projections/gs50.rst | 10 + docs/source/operations/projections/gstmerc.rst | 10 + docs/source/operations/projections/hammer.rst | 10 + docs/source/operations/projections/hatano.rst | 70 ++++ docs/source/operations/projections/healpix.rst | 55 +++ docs/source/operations/projections/igh.rst | 10 + docs/source/operations/projections/images/aea.png | Bin 0 -> 273668 bytes docs/source/operations/projections/images/aeqd.png | Bin 0 -> 242075 bytes docs/source/operations/projections/images/airy.png | Bin 0 -> 193140 bytes .../operations/projections/images/aitoff.png | Bin 0 -> 281655 bytes docs/source/operations/projections/images/alsk.png | Bin 0 -> 89331 bytes .../source/operations/projections/images/apian.png | Bin 0 -> 232910 bytes .../operations/projections/images/august.png | Bin 0 -> 264816 bytes .../source/operations/projections/images/bacon.png | Bin 0 -> 232456 bytes docs/source/operations/projections/images/bipc.png | Bin 0 -> 214330 bytes .../source/operations/projections/images/boggs.png | Bin 0 -> 243618 bytes .../source/operations/projections/images/bonne.png | Bin 0 -> 290097 bytes .../operations/projections/images/calcofi.png | Bin 0 -> 316606 bytes docs/source/operations/projections/images/cass.png | Bin 0 -> 207715 bytes docs/source/operations/projections/images/cc.png | Bin 0 -> 100206 bytes docs/source/operations/projections/images/ccon.png | Bin 0 -> 205856 bytes docs/source/operations/projections/images/cea.png | Bin 0 -> 96163 bytes .../source/operations/projections/images/chamb.png | Bin 0 -> 301159 bytes .../source/operations/projections/images/collg.png | Bin 0 -> 211969 bytes .../operations/projections/images/comill.png | Bin 0 -> 100906 bytes .../source/operations/projections/images/crast.png | Bin 0 -> 240748 bytes .../source/operations/projections/images/denoy.png | Bin 0 -> 242689 bytes docs/source/operations/projections/images/eck1.png | Bin 0 -> 226331 bytes docs/source/operations/projections/images/eck2.png | Bin 0 -> 227996 bytes docs/source/operations/projections/images/eck3.png | Bin 0 -> 229072 bytes docs/source/operations/projections/images/eck4.png | Bin 0 -> 228930 bytes docs/source/operations/projections/images/eck5.png | Bin 0 -> 227661 bytes docs/source/operations/projections/images/eck6.png | Bin 0 -> 228739 bytes docs/source/operations/projections/images/eqc.png | Bin 0 -> 99881 bytes docs/source/operations/projections/images/eqdc.png | Bin 0 -> 253069 bytes .../operations/projections/images/etmerc.png | Bin 0 -> 296004 bytes .../source/operations/projections/images/euler.png | Bin 0 -> 260706 bytes .../source/operations/projections/images/fahey.png | Bin 0 -> 243833 bytes docs/source/operations/projections/images/fouc.png | Bin 0 -> 226398 bytes .../operations/projections/images/fouc_s.png | Bin 0 -> 96801 bytes docs/source/operations/projections/images/gall.png | Bin 0 -> 99516 bytes docs/source/operations/projections/images/geos.png | Bin 0 -> 155703 bytes .../source/operations/projections/images/gins8.png | Bin 0 -> 231431 bytes .../operations/projections/images/gn_sinu.png | Bin 0 -> 198410 bytes docs/source/operations/projections/images/gnom.png | Bin 0 -> 183664 bytes .../source/operations/projections/images/goode.png | Bin 0 -> 245463 bytes docs/source/operations/projections/images/gs48.png | Bin 0 -> 79575 bytes docs/source/operations/projections/images/gs50.png | Bin 0 -> 127915 bytes .../operations/projections/images/gstmerc.png | Bin 0 -> 259585 bytes .../operations/projections/images/hammer.png | Bin 0 -> 282624 bytes .../operations/projections/images/hatano.png | Bin 0 -> 215598 bytes .../operations/projections/images/healpix.png | Bin 0 -> 171513 bytes docs/source/operations/projections/images/igh.png | Bin 0 -> 232327 bytes .../source/operations/projections/images/imw_p.png | Bin 0 -> 188272 bytes docs/source/operations/projections/images/isea.png | Bin 0 -> 310106 bytes docs/source/operations/projections/images/kav5.png | Bin 0 -> 244578 bytes docs/source/operations/projections/images/kav7.png | Bin 0 -> 229109 bytes .../operations/projections/images/krovak.png | Bin 0 -> 70429 bytes .../source/operations/projections/images/labrd.png | Bin 0 -> 48609 bytes docs/source/operations/projections/images/laea.png | Bin 0 -> 288272 bytes .../operations/projections/images/lagrng.png | Bin 0 -> 281932 bytes docs/source/operations/projections/images/larr.png | Bin 0 -> 255324 bytes docs/source/operations/projections/images/lask.png | Bin 0 -> 276892 bytes docs/source/operations/projections/images/lcc.png | Bin 0 -> 163094 bytes docs/source/operations/projections/images/lcca.png | Bin 0 -> 235626 bytes docs/source/operations/projections/images/leac.png | Bin 0 -> 306096 bytes .../operations/projections/images/lee_os.png | Bin 0 -> 141797 bytes .../source/operations/projections/images/loxim.png | Bin 0 -> 241566 bytes docs/source/operations/projections/images/lsat.png | Bin 0 -> 14385 bytes .../operations/projections/images/mbt_fps.png | Bin 0 -> 241457 bytes .../source/operations/projections/images/mbt_s.png | Bin 0 -> 245067 bytes .../operations/projections/images/mbtfpp.png | Bin 0 -> 236235 bytes .../operations/projections/images/mbtfpq.png | Bin 0 -> 237516 bytes .../operations/projections/images/mbtfps.png | Bin 0 -> 235738 bytes docs/source/operations/projections/images/merc.png | Bin 0 -> 100334 bytes .../operations/projections/images/mil_os.png | Bin 0 -> 136269 bytes docs/source/operations/projections/images/mill.png | Bin 0 -> 97862 bytes .../operations/projections/images/misrsom.png | Bin 0 -> 293190 bytes docs/source/operations/projections/images/moll.png | Bin 0 -> 244671 bytes .../source/operations/projections/images/murd1.png | Bin 0 -> 234038 bytes .../source/operations/projections/images/murd2.png | Bin 0 -> 175431 bytes .../source/operations/projections/images/murd3.png | Bin 0 -> 229304 bytes .../operations/projections/images/natearth.png | Bin 0 -> 228702 bytes .../operations/projections/images/natearth2.png | Bin 0 -> 240763 bytes docs/source/operations/projections/images/nell.png | Bin 0 -> 213589 bytes .../operations/projections/images/nell_h.png | Bin 0 -> 230244 bytes .../source/operations/projections/images/nicol.png | Bin 0 -> 263585 bytes .../source/operations/projections/images/nsper.png | Bin 0 -> 133200 bytes docs/source/operations/projections/images/nzmg.png | Bin 0 -> 50472 bytes .../operations/projections/images/ob_tran.png | Bin 0 -> 272387 bytes docs/source/operations/projections/images/ocea.png | Bin 0 -> 93093 bytes docs/source/operations/projections/images/oea.png | Bin 0 -> 351858 bytes .../source/operations/projections/images/omerc.png | Bin 0 -> 231077 bytes .../source/operations/projections/images/ortel.png | Bin 0 -> 197532 bytes .../source/operations/projections/images/ortho.png | Bin 0 -> 156144 bytes .../operations/projections/images/patterson.png | Bin 0 -> 102271 bytes .../operations/projections/images/pconic.png | Bin 0 -> 200664 bytes docs/source/operations/projections/images/poly.png | Bin 0 -> 270344 bytes .../source/operations/projections/images/putp1.png | Bin 0 -> 243490 bytes .../source/operations/projections/images/putp2.png | Bin 0 -> 243377 bytes .../source/operations/projections/images/putp3.png | Bin 0 -> 240811 bytes .../operations/projections/images/putp3p.png | Bin 0 -> 228904 bytes .../operations/projections/images/putp4p.png | Bin 0 -> 230226 bytes .../source/operations/projections/images/putp5.png | Bin 0 -> 237811 bytes .../operations/projections/images/putp5p.png | Bin 0 -> 228264 bytes .../source/operations/projections/images/putp6.png | Bin 0 -> 238235 bytes .../operations/projections/images/putp6p.png | Bin 0 -> 229779 bytes docs/source/operations/projections/images/qsc.png | Bin 0 -> 297806 bytes .../operations/projections/images/qua_aut.png | Bin 0 -> 242497 bytes .../operations/projections/images/rhealpix.png | Bin 0 -> 393316 bytes .../source/operations/projections/images/robin.png | Bin 0 -> 228460 bytes .../source/operations/projections/images/rouss.png | Bin 0 -> 234337 bytes .../source/operations/projections/images/rpoly.png | Bin 0 -> 275448 bytes docs/source/operations/projections/images/sinu.png | Bin 0 -> 236312 bytes .../operations/projections/images/somerc.png | Bin 0 -> 87704 bytes .../source/operations/projections/images/stere.png | Bin 0 -> 176565 bytes .../operations/projections/images/sterea.png | Bin 0 -> 175090 bytes docs/source/operations/projections/images/tcc.png | Bin 0 -> 121474 bytes docs/source/operations/projections/images/tcea.png | Bin 0 -> 331583 bytes .../operations/projections/images/tissot.png | Bin 0 -> 268068 bytes .../source/operations/projections/images/tmerc.png | Bin 0 -> 186992 bytes .../source/operations/projections/images/tpeqd.png | Bin 0 -> 297972 bytes .../source/operations/projections/images/tpers.png | Bin 0 -> 156134 bytes docs/source/operations/projections/images/ups.png | Bin 0 -> 201068 bytes docs/source/operations/projections/images/urm5.png | Bin 0 -> 232637 bytes .../operations/projections/images/urmfps.png | Bin 0 -> 189587 bytes docs/source/operations/projections/images/utm.png | Bin 0 -> 305727 bytes .../source/operations/projections/images/vandg.png | Bin 0 -> 274126 bytes .../operations/projections/images/vandg2.png | Bin 0 -> 286774 bytes .../operations/projections/images/vandg3.png | Bin 0 -> 239999 bytes .../operations/projections/images/vandg4.png | Bin 0 -> 273833 bytes .../source/operations/projections/images/vitk1.png | Bin 0 -> 251858 bytes docs/source/operations/projections/images/wag1.png | Bin 0 -> 230113 bytes docs/source/operations/projections/images/wag2.png | Bin 0 -> 229235 bytes docs/source/operations/projections/images/wag3.png | Bin 0 -> 228764 bytes docs/source/operations/projections/images/wag4.png | Bin 0 -> 230059 bytes docs/source/operations/projections/images/wag5.png | Bin 0 -> 231608 bytes docs/source/operations/projections/images/wag6.png | Bin 0 -> 229507 bytes docs/source/operations/projections/images/wag7.png | Bin 0 -> 262121 bytes .../source/operations/projections/images/weren.png | Bin 0 -> 230046 bytes .../source/operations/projections/images/wink1.png | Bin 0 -> 228017 bytes .../source/operations/projections/images/wink2.png | Bin 0 -> 229994 bytes .../operations/projections/images/wintri.png | Bin 0 -> 266146 bytes docs/source/operations/projections/imw_p.rst | 10 + docs/source/operations/projections/index.rst | 146 ++++++++ docs/source/operations/projections/isea.rst | 10 + docs/source/operations/projections/kav5.rst | 10 + docs/source/operations/projections/kav7.rst | 10 + docs/source/operations/projections/krovak.rst | 10 + docs/source/operations/projections/labrd.rst | 10 + docs/source/operations/projections/laea.rst | 10 + docs/source/operations/projections/lagrng.rst | 10 + docs/source/operations/projections/larr.rst | 10 + docs/source/operations/projections/lask.rst | 10 + docs/source/operations/projections/lcc.rst | 10 + docs/source/operations/projections/lcca.rst | 10 + docs/source/operations/projections/leac.rst | 10 + docs/source/operations/projections/lee_os.rst | 10 + docs/source/operations/projections/loxim.rst | 10 + docs/source/operations/projections/lsat.rst | 10 + docs/source/operations/projections/mbt_fps.rst | 10 + docs/source/operations/projections/mbt_s.rst | 10 + docs/source/operations/projections/mbtfpp.rst | 10 + docs/source/operations/projections/mbtfpq.rst | 10 + docs/source/operations/projections/mbtfps.rst | 10 + docs/source/operations/projections/merc.rst | 140 ++++++++ docs/source/operations/projections/mil_os.rst | 10 + docs/source/operations/projections/mill.rst | 72 ++++ docs/source/operations/projections/moll.rst | 10 + docs/source/operations/projections/murd1.rst | 10 + docs/source/operations/projections/murd2.rst | 10 + docs/source/operations/projections/murd3.rst | 10 + docs/source/operations/projections/natearth.rst | 47 +++ docs/source/operations/projections/nell.rst | 10 + docs/source/operations/projections/nell_h.rst | 10 + docs/source/operations/projections/nicol.rst | 10 + docs/source/operations/projections/nsper.rst | 10 + docs/source/operations/projections/nzmg.rst | 10 + docs/source/operations/projections/ob_tran.rst | 10 + docs/source/operations/projections/ocea.rst | 10 + docs/source/operations/projections/oea.rst | 10 + docs/source/operations/projections/omerc.rst | 10 + docs/source/operations/projections/ortel.rst | 10 + docs/source/operations/projections/ortho.rst | 10 + docs/source/operations/projections/pconic.rst | 10 + docs/source/operations/projections/poly.rst | 10 + docs/source/operations/projections/putp1.rst | 10 + docs/source/operations/projections/putp2.rst | 10 + docs/source/operations/projections/putp3.rst | 10 + docs/source/operations/projections/putp3p.rst | 10 + docs/source/operations/projections/putp4p.rst | 10 + docs/source/operations/projections/putp5.rst | 10 + docs/source/operations/projections/putp5p.rst | 10 + docs/source/operations/projections/putp6.rst | 10 + docs/source/operations/projections/putp6p.rst | 10 + docs/source/operations/projections/qsc.rst | 158 +++++++++ docs/source/operations/projections/qua_aut.rst | 10 + docs/source/operations/projections/rhealpix.rst | 51 +++ docs/source/operations/projections/robin.rst | 10 + docs/source/operations/projections/rouss.rst | 10 + docs/source/operations/projections/rpoly.rst | 10 + docs/source/operations/projections/sinu.rst | 24 ++ docs/source/operations/projections/somerc.rst | 10 + docs/source/operations/projections/stere.rst | 10 + docs/source/operations/projections/sterea.rst | 10 + docs/source/operations/projections/tcc.rst | 10 + docs/source/operations/projections/tcea.rst | 10 + docs/source/operations/projections/tissot.rst | 10 + docs/source/operations/projections/tmerc.rst | 197 +++++++++++ docs/source/operations/projections/tpeqd.rst | 10 + docs/source/operations/projections/tpers.rst | 39 +++ docs/source/operations/projections/ups.rst | 10 + docs/source/operations/projections/urm5.rst | 10 + docs/source/operations/projections/urmfps.rst | 10 + docs/source/operations/projections/utm.rst | 10 + docs/source/operations/projections/vandg.rst | 10 + docs/source/operations/projections/vandg2.rst | 10 + docs/source/operations/projections/vandg3.rst | 10 + docs/source/operations/projections/vandg4.rst | 10 + docs/source/operations/projections/vitk1.rst | 10 + docs/source/operations/projections/wag1.rst | 10 + docs/source/operations/projections/wag2.rst | 18 + docs/source/operations/projections/wag3.rst | 16 + docs/source/operations/projections/wag4.rst | 10 + docs/source/operations/projections/wag5.rst | 10 + docs/source/operations/projections/wag6.rst | 10 + docs/source/operations/projections/wag7.rst | 10 + docs/source/operations/projections/weren.rst | 10 + docs/source/operations/projections/wink1.rst | 10 + docs/source/operations/projections/wink2.rst | 10 + docs/source/operations/projections/wintri.rst | 10 + .../operations/transformations/deformation.rst | 148 ++++++++ docs/source/operations/transformations/helmert.rst | 388 +++++++++++++++++++++ .../operations/transformations/hgridshift.rst | 39 +++ docs/source/operations/transformations/index.rst | 17 + .../operations/transformations/molodensky.rst | 74 ++++ .../operations/transformations/vgridshift.rst | 41 +++ docs/source/resource_files.rst | 6 +- docs/source/usage/environmentvars.rst | 2 +- docs/source/usage/index.rst | 1 - .../usage/operations/conversions/axisswap.rst | 39 --- docs/source/usage/operations/conversions/cart.rst | 24 -- docs/source/usage/operations/conversions/index.rst | 18 - .../source/usage/operations/conversions/latlon.rst | 6 - .../source/usage/operations/conversions/lonlat.rst | 6 - .../usage/operations/conversions/unitconvert.rst | 112 ------ docs/source/usage/operations/index.rst | 22 -- docs/source/usage/operations/pipeline.rst | 98 ------ docs/source/usage/operations/projections/aeqd.rst | 22 -- docs/source/usage/operations/projections/airy.rst | 26 -- .../source/usage/operations/projections/aitoff.rst | 10 - docs/source/usage/operations/projections/alsk.rst | 10 - docs/source/usage/operations/projections/apian.rst | 10 - .../source/usage/operations/projections/august.rst | 10 - docs/source/usage/operations/projections/bacon.rst | 10 - docs/source/usage/operations/projections/bipc.rst | 10 - docs/source/usage/operations/projections/boggs.rst | 10 - docs/source/usage/operations/projections/bonne.rst | 10 - .../usage/operations/projections/calcofi.rst | 95 ----- docs/source/usage/operations/projections/cass.rst | 145 -------- docs/source/usage/operations/projections/cc.rst | 10 - docs/source/usage/operations/projections/ccon.rst | 127 ------- docs/source/usage/operations/projections/cea.rst | 10 - docs/source/usage/operations/projections/chamb.rst | 10 - docs/source/usage/operations/projections/collg.rst | 10 - docs/source/usage/operations/projections/crast.rst | 10 - docs/source/usage/operations/projections/denoy.rst | 10 - docs/source/usage/operations/projections/eck1.rst | 18 - docs/source/usage/operations/projections/eck2.rst | 10 - docs/source/usage/operations/projections/eck3.rst | 10 - docs/source/usage/operations/projections/eck4.rst | 19 - docs/source/usage/operations/projections/eck5.rst | 10 - docs/source/usage/operations/projections/eck6.rst | 10 - docs/source/usage/operations/projections/eqc.rst | 110 ------ docs/source/usage/operations/projections/eqdc.rst | 10 - .../source/usage/operations/projections/etmerc.rst | 10 - docs/source/usage/operations/projections/euler.rst | 10 - docs/source/usage/operations/projections/fahey.rst | 10 - docs/source/usage/operations/projections/fouc.rst | 10 - .../source/usage/operations/projections/fouc_s.rst | 25 -- docs/source/usage/operations/projections/gall.rst | 84 ----- docs/source/usage/operations/projections/geos.rst | 72 ---- docs/source/usage/operations/projections/gins8.rst | 10 - .../usage/operations/projections/gn_sinu.rst | 10 - docs/source/usage/operations/projections/gnom.rst | 10 - docs/source/usage/operations/projections/goode.rst | 10 - docs/source/usage/operations/projections/gs48.rst | 10 - docs/source/usage/operations/projections/gs50.rst | 10 - .../usage/operations/projections/gstmerc.rst | 10 - .../source/usage/operations/projections/hammer.rst | 10 - .../source/usage/operations/projections/hatano.rst | 70 ---- .../usage/operations/projections/healpix.rst | 55 --- docs/source/usage/operations/projections/igh.rst | 10 - .../usage/operations/projections/images/aea.png | Bin 273668 -> 0 bytes .../usage/operations/projections/images/aeqd.png | Bin 242075 -> 0 bytes .../usage/operations/projections/images/airy.png | Bin 193140 -> 0 bytes .../usage/operations/projections/images/aitoff.png | Bin 281655 -> 0 bytes .../usage/operations/projections/images/alsk.png | Bin 89331 -> 0 bytes .../usage/operations/projections/images/apian.png | Bin 232910 -> 0 bytes .../usage/operations/projections/images/august.png | Bin 264816 -> 0 bytes .../usage/operations/projections/images/bacon.png | Bin 232456 -> 0 bytes .../usage/operations/projections/images/bipc.png | Bin 214330 -> 0 bytes .../usage/operations/projections/images/boggs.png | Bin 243618 -> 0 bytes .../usage/operations/projections/images/bonne.png | Bin 290097 -> 0 bytes .../operations/projections/images/calcofi.png | Bin 316606 -> 0 bytes .../usage/operations/projections/images/cass.png | Bin 207715 -> 0 bytes .../usage/operations/projections/images/cc.png | Bin 100206 -> 0 bytes .../usage/operations/projections/images/ccon.png | Bin 205856 -> 0 bytes .../usage/operations/projections/images/cea.png | Bin 96163 -> 0 bytes .../usage/operations/projections/images/chamb.png | Bin 301159 -> 0 bytes .../usage/operations/projections/images/collg.png | Bin 211969 -> 0 bytes .../usage/operations/projections/images/comill.png | Bin 100906 -> 0 bytes .../usage/operations/projections/images/crast.png | Bin 240748 -> 0 bytes .../usage/operations/projections/images/denoy.png | Bin 242689 -> 0 bytes .../usage/operations/projections/images/eck1.png | Bin 226331 -> 0 bytes .../usage/operations/projections/images/eck2.png | Bin 227996 -> 0 bytes .../usage/operations/projections/images/eck3.png | Bin 229072 -> 0 bytes .../usage/operations/projections/images/eck4.png | Bin 228930 -> 0 bytes .../usage/operations/projections/images/eck5.png | Bin 227661 -> 0 bytes .../usage/operations/projections/images/eck6.png | Bin 228739 -> 0 bytes .../usage/operations/projections/images/eqc.png | Bin 99881 -> 0 bytes .../usage/operations/projections/images/eqdc.png | Bin 253069 -> 0 bytes .../usage/operations/projections/images/etmerc.png | Bin 296004 -> 0 bytes .../usage/operations/projections/images/euler.png | Bin 260706 -> 0 bytes .../usage/operations/projections/images/fahey.png | Bin 243833 -> 0 bytes .../usage/operations/projections/images/fouc.png | Bin 226398 -> 0 bytes .../usage/operations/projections/images/fouc_s.png | Bin 96801 -> 0 bytes .../usage/operations/projections/images/gall.png | Bin 99516 -> 0 bytes .../usage/operations/projections/images/geos.png | Bin 155703 -> 0 bytes .../usage/operations/projections/images/gins8.png | Bin 231431 -> 0 bytes .../operations/projections/images/gn_sinu.png | Bin 198410 -> 0 bytes .../usage/operations/projections/images/gnom.png | Bin 183664 -> 0 bytes .../usage/operations/projections/images/goode.png | Bin 245463 -> 0 bytes .../usage/operations/projections/images/gs48.png | Bin 79575 -> 0 bytes .../usage/operations/projections/images/gs50.png | Bin 127915 -> 0 bytes .../operations/projections/images/gstmerc.png | Bin 259585 -> 0 bytes .../usage/operations/projections/images/hammer.png | Bin 282624 -> 0 bytes .../usage/operations/projections/images/hatano.png | Bin 215598 -> 0 bytes .../operations/projections/images/healpix.png | Bin 171513 -> 0 bytes .../usage/operations/projections/images/igh.png | Bin 232327 -> 0 bytes .../usage/operations/projections/images/imw_p.png | Bin 188272 -> 0 bytes .../usage/operations/projections/images/isea.png | Bin 310106 -> 0 bytes .../usage/operations/projections/images/kav5.png | Bin 244578 -> 0 bytes .../usage/operations/projections/images/kav7.png | Bin 229109 -> 0 bytes .../usage/operations/projections/images/krovak.png | Bin 70429 -> 0 bytes .../usage/operations/projections/images/labrd.png | Bin 48609 -> 0 bytes .../usage/operations/projections/images/laea.png | Bin 288272 -> 0 bytes .../usage/operations/projections/images/lagrng.png | Bin 281932 -> 0 bytes .../usage/operations/projections/images/larr.png | Bin 255324 -> 0 bytes .../usage/operations/projections/images/lask.png | Bin 276892 -> 0 bytes .../usage/operations/projections/images/lcc.png | Bin 163094 -> 0 bytes .../usage/operations/projections/images/lcca.png | Bin 235626 -> 0 bytes .../usage/operations/projections/images/leac.png | Bin 306096 -> 0 bytes .../usage/operations/projections/images/lee_os.png | Bin 141797 -> 0 bytes .../usage/operations/projections/images/loxim.png | Bin 241566 -> 0 bytes .../usage/operations/projections/images/lsat.png | Bin 14385 -> 0 bytes .../operations/projections/images/mbt_fps.png | Bin 241457 -> 0 bytes .../usage/operations/projections/images/mbt_s.png | Bin 245067 -> 0 bytes .../usage/operations/projections/images/mbtfpp.png | Bin 236235 -> 0 bytes .../usage/operations/projections/images/mbtfpq.png | Bin 237516 -> 0 bytes .../usage/operations/projections/images/mbtfps.png | Bin 235738 -> 0 bytes .../usage/operations/projections/images/merc.png | Bin 100334 -> 0 bytes .../usage/operations/projections/images/mil_os.png | Bin 136269 -> 0 bytes .../usage/operations/projections/images/mill.png | Bin 97862 -> 0 bytes .../operations/projections/images/misrsom.png | Bin 293190 -> 0 bytes .../usage/operations/projections/images/moll.png | Bin 244671 -> 0 bytes .../usage/operations/projections/images/murd1.png | Bin 234038 -> 0 bytes .../usage/operations/projections/images/murd2.png | Bin 175431 -> 0 bytes .../usage/operations/projections/images/murd3.png | Bin 229304 -> 0 bytes .../operations/projections/images/natearth.png | Bin 228702 -> 0 bytes .../operations/projections/images/natearth2.png | Bin 240763 -> 0 bytes .../usage/operations/projections/images/nell.png | Bin 213589 -> 0 bytes .../usage/operations/projections/images/nell_h.png | Bin 230244 -> 0 bytes .../usage/operations/projections/images/nicol.png | Bin 263585 -> 0 bytes .../usage/operations/projections/images/nsper.png | Bin 133200 -> 0 bytes .../usage/operations/projections/images/nzmg.png | Bin 50472 -> 0 bytes .../operations/projections/images/ob_tran.png | Bin 272387 -> 0 bytes .../usage/operations/projections/images/ocea.png | Bin 93093 -> 0 bytes .../usage/operations/projections/images/oea.png | Bin 351858 -> 0 bytes .../usage/operations/projections/images/omerc.png | Bin 231077 -> 0 bytes .../usage/operations/projections/images/ortel.png | Bin 197532 -> 0 bytes .../usage/operations/projections/images/ortho.png | Bin 156144 -> 0 bytes .../operations/projections/images/patterson.png | Bin 102271 -> 0 bytes .../usage/operations/projections/images/pconic.png | Bin 200664 -> 0 bytes .../usage/operations/projections/images/poly.png | Bin 270344 -> 0 bytes .../usage/operations/projections/images/putp1.png | Bin 243490 -> 0 bytes .../usage/operations/projections/images/putp2.png | Bin 243377 -> 0 bytes .../usage/operations/projections/images/putp3.png | Bin 240811 -> 0 bytes .../usage/operations/projections/images/putp3p.png | Bin 228904 -> 0 bytes .../usage/operations/projections/images/putp4p.png | Bin 230226 -> 0 bytes .../usage/operations/projections/images/putp5.png | Bin 237811 -> 0 bytes .../usage/operations/projections/images/putp5p.png | Bin 228264 -> 0 bytes .../usage/operations/projections/images/putp6.png | Bin 238235 -> 0 bytes .../usage/operations/projections/images/putp6p.png | Bin 229779 -> 0 bytes .../usage/operations/projections/images/qsc.png | Bin 297806 -> 0 bytes .../operations/projections/images/qua_aut.png | Bin 242497 -> 0 bytes .../operations/projections/images/rhealpix.png | Bin 393316 -> 0 bytes .../usage/operations/projections/images/robin.png | Bin 228460 -> 0 bytes .../usage/operations/projections/images/rouss.png | Bin 234337 -> 0 bytes .../usage/operations/projections/images/rpoly.png | Bin 275448 -> 0 bytes .../usage/operations/projections/images/sinu.png | Bin 236312 -> 0 bytes .../usage/operations/projections/images/somerc.png | Bin 87704 -> 0 bytes .../usage/operations/projections/images/stere.png | Bin 176565 -> 0 bytes .../usage/operations/projections/images/sterea.png | Bin 175090 -> 0 bytes .../usage/operations/projections/images/tcc.png | Bin 121474 -> 0 bytes .../usage/operations/projections/images/tcea.png | Bin 331583 -> 0 bytes .../usage/operations/projections/images/tissot.png | Bin 268068 -> 0 bytes .../usage/operations/projections/images/tmerc.png | Bin 186992 -> 0 bytes .../usage/operations/projections/images/tpeqd.png | Bin 297972 -> 0 bytes .../usage/operations/projections/images/tpers.png | Bin 156134 -> 0 bytes .../usage/operations/projections/images/ups.png | Bin 201068 -> 0 bytes .../usage/operations/projections/images/urm5.png | Bin 232637 -> 0 bytes .../usage/operations/projections/images/urmfps.png | Bin 189587 -> 0 bytes .../usage/operations/projections/images/utm.png | Bin 305727 -> 0 bytes .../usage/operations/projections/images/vandg.png | Bin 274126 -> 0 bytes .../usage/operations/projections/images/vandg2.png | Bin 286774 -> 0 bytes .../usage/operations/projections/images/vandg3.png | Bin 239999 -> 0 bytes .../usage/operations/projections/images/vandg4.png | Bin 273833 -> 0 bytes .../usage/operations/projections/images/vitk1.png | Bin 251858 -> 0 bytes .../usage/operations/projections/images/wag1.png | Bin 230113 -> 0 bytes .../usage/operations/projections/images/wag2.png | Bin 229235 -> 0 bytes .../usage/operations/projections/images/wag3.png | Bin 228764 -> 0 bytes .../usage/operations/projections/images/wag4.png | Bin 230059 -> 0 bytes .../usage/operations/projections/images/wag5.png | Bin 231608 -> 0 bytes .../usage/operations/projections/images/wag6.png | Bin 229507 -> 0 bytes .../usage/operations/projections/images/wag7.png | Bin 262121 -> 0 bytes .../usage/operations/projections/images/weren.png | Bin 230046 -> 0 bytes .../usage/operations/projections/images/wink1.png | Bin 228017 -> 0 bytes .../usage/operations/projections/images/wink2.png | Bin 229994 -> 0 bytes .../usage/operations/projections/images/wintri.png | Bin 266146 -> 0 bytes docs/source/usage/operations/projections/imw_p.rst | 10 - docs/source/usage/operations/projections/index.rst | 146 -------- docs/source/usage/operations/projections/isea.rst | 10 - docs/source/usage/operations/projections/kav5.rst | 10 - docs/source/usage/operations/projections/kav7.rst | 10 - .../source/usage/operations/projections/krovak.rst | 10 - docs/source/usage/operations/projections/labrd.rst | 10 - docs/source/usage/operations/projections/laea.rst | 10 - .../source/usage/operations/projections/lagrng.rst | 10 - docs/source/usage/operations/projections/larr.rst | 10 - docs/source/usage/operations/projections/lask.rst | 10 - docs/source/usage/operations/projections/lcc.rst | 10 - docs/source/usage/operations/projections/lcca.rst | 10 - docs/source/usage/operations/projections/leac.rst | 10 - .../source/usage/operations/projections/lee_os.rst | 10 - docs/source/usage/operations/projections/loxim.rst | 10 - docs/source/usage/operations/projections/lsat.rst | 10 - .../usage/operations/projections/mbt_fps.rst | 10 - docs/source/usage/operations/projections/mbt_s.rst | 10 - .../source/usage/operations/projections/mbtfpp.rst | 10 - .../source/usage/operations/projections/mbtfpq.rst | 10 - .../source/usage/operations/projections/mbtfps.rst | 10 - docs/source/usage/operations/projections/merc.rst | 140 -------- .../source/usage/operations/projections/mil_os.rst | 10 - docs/source/usage/operations/projections/mill.rst | 72 ---- docs/source/usage/operations/projections/moll.rst | 10 - docs/source/usage/operations/projections/murd1.rst | 10 - docs/source/usage/operations/projections/murd2.rst | 10 - docs/source/usage/operations/projections/murd3.rst | 10 - .../usage/operations/projections/natearth.rst | 47 --- docs/source/usage/operations/projections/nell.rst | 10 - .../source/usage/operations/projections/nell_h.rst | 10 - docs/source/usage/operations/projections/nicol.rst | 10 - docs/source/usage/operations/projections/nsper.rst | 10 - docs/source/usage/operations/projections/nzmg.rst | 10 - .../usage/operations/projections/ob_tran.rst | 10 - docs/source/usage/operations/projections/ocea.rst | 10 - docs/source/usage/operations/projections/oea.rst | 10 - docs/source/usage/operations/projections/omerc.rst | 10 - docs/source/usage/operations/projections/ortel.rst | 10 - docs/source/usage/operations/projections/ortho.rst | 10 - .../source/usage/operations/projections/pconic.rst | 10 - docs/source/usage/operations/projections/poly.rst | 10 - docs/source/usage/operations/projections/putp1.rst | 10 - docs/source/usage/operations/projections/putp2.rst | 10 - docs/source/usage/operations/projections/putp3.rst | 10 - .../source/usage/operations/projections/putp3p.rst | 10 - .../source/usage/operations/projections/putp4p.rst | 10 - docs/source/usage/operations/projections/putp5.rst | 10 - .../source/usage/operations/projections/putp5p.rst | 10 - docs/source/usage/operations/projections/putp6.rst | 10 - .../source/usage/operations/projections/putp6p.rst | 10 - docs/source/usage/operations/projections/qsc.rst | 158 --------- .../usage/operations/projections/qua_aut.rst | 10 - .../usage/operations/projections/rhealpix.rst | 51 --- docs/source/usage/operations/projections/robin.rst | 10 - docs/source/usage/operations/projections/rouss.rst | 10 - docs/source/usage/operations/projections/rpoly.rst | 10 - docs/source/usage/operations/projections/sinu.rst | 24 -- .../source/usage/operations/projections/somerc.rst | 10 - docs/source/usage/operations/projections/stere.rst | 10 - .../source/usage/operations/projections/sterea.rst | 10 - docs/source/usage/operations/projections/tcc.rst | 10 - docs/source/usage/operations/projections/tcea.rst | 10 - .../source/usage/operations/projections/tissot.rst | 10 - docs/source/usage/operations/projections/tmerc.rst | 197 ----------- docs/source/usage/operations/projections/tpeqd.rst | 10 - docs/source/usage/operations/projections/tpers.rst | 39 --- docs/source/usage/operations/projections/ups.rst | 10 - docs/source/usage/operations/projections/urm5.rst | 10 - .../source/usage/operations/projections/urmfps.rst | 10 - docs/source/usage/operations/projections/utm.rst | 10 - docs/source/usage/operations/projections/vandg.rst | 10 - .../source/usage/operations/projections/vandg2.rst | 10 - .../source/usage/operations/projections/vandg3.rst | 10 - .../source/usage/operations/projections/vandg4.rst | 10 - docs/source/usage/operations/projections/vitk1.rst | 10 - docs/source/usage/operations/projections/wag1.rst | 10 - docs/source/usage/operations/projections/wag2.rst | 18 - docs/source/usage/operations/projections/wag3.rst | 16 - docs/source/usage/operations/projections/wag4.rst | 10 - docs/source/usage/operations/projections/wag5.rst | 10 - docs/source/usage/operations/projections/wag6.rst | 10 - docs/source/usage/operations/projections/wag7.rst | 10 - docs/source/usage/operations/projections/weren.rst | 10 - docs/source/usage/operations/projections/wink1.rst | 10 - docs/source/usage/operations/projections/wink2.rst | 10 - .../source/usage/operations/projections/wintri.rst | 10 - .../operations/transformations/deformation.rst | 148 -------- .../usage/operations/transformations/helmert.rst | 388 --------------------- .../operations/transformations/hgridshift.rst | 39 --- .../usage/operations/transformations/index.rst | 17 - .../operations/transformations/molodensky.rst | 74 ---- .../operations/transformations/vgridshift.rst | 41 --- docs/source/usage/projections.rst | 6 +- docs/source/usage/quickstart.rst | 2 +- docs/source/usage/transformation.rst | 2 +- 575 files changed, 3909 insertions(+), 3907 deletions(-) create mode 100644 docs/source/operations/conversions/axisswap.rst create mode 100644 docs/source/operations/conversions/cart.rst create mode 100644 docs/source/operations/conversions/index.rst create mode 100644 docs/source/operations/conversions/latlon.rst create mode 100644 docs/source/operations/conversions/lonlat.rst create mode 100644 docs/source/operations/conversions/unitconvert.rst create mode 100644 docs/source/operations/index.rst create mode 100644 docs/source/operations/pipeline.rst create mode 100644 docs/source/operations/projections/aeqd.rst create mode 100644 docs/source/operations/projections/airy.rst create mode 100644 docs/source/operations/projections/aitoff.rst create mode 100644 docs/source/operations/projections/alsk.rst create mode 100644 docs/source/operations/projections/apian.rst create mode 100644 docs/source/operations/projections/august.rst create mode 100644 docs/source/operations/projections/bacon.rst create mode 100644 docs/source/operations/projections/bipc.rst create mode 100644 docs/source/operations/projections/boggs.rst create mode 100644 docs/source/operations/projections/bonne.rst create mode 100644 docs/source/operations/projections/calcofi.rst create mode 100644 docs/source/operations/projections/cass.rst create mode 100644 docs/source/operations/projections/cc.rst create mode 100644 docs/source/operations/projections/ccon.rst create mode 100644 docs/source/operations/projections/cea.rst create mode 100644 docs/source/operations/projections/chamb.rst create mode 100644 docs/source/operations/projections/collg.rst create mode 100644 docs/source/operations/projections/crast.rst create mode 100644 docs/source/operations/projections/denoy.rst create mode 100644 docs/source/operations/projections/eck1.rst create mode 100644 docs/source/operations/projections/eck2.rst create mode 100644 docs/source/operations/projections/eck3.rst create mode 100644 docs/source/operations/projections/eck4.rst create mode 100644 docs/source/operations/projections/eck5.rst create mode 100644 docs/source/operations/projections/eck6.rst create mode 100644 docs/source/operations/projections/eqc.rst create mode 100644 docs/source/operations/projections/eqdc.rst create mode 100644 docs/source/operations/projections/etmerc.rst create mode 100644 docs/source/operations/projections/euler.rst create mode 100644 docs/source/operations/projections/fahey.rst create mode 100644 docs/source/operations/projections/fouc.rst create mode 100644 docs/source/operations/projections/fouc_s.rst create mode 100644 docs/source/operations/projections/gall.rst create mode 100644 docs/source/operations/projections/geos.rst create mode 100644 docs/source/operations/projections/gins8.rst create mode 100644 docs/source/operations/projections/gn_sinu.rst create mode 100644 docs/source/operations/projections/gnom.rst create mode 100644 docs/source/operations/projections/goode.rst create mode 100644 docs/source/operations/projections/gs48.rst create mode 100644 docs/source/operations/projections/gs50.rst create mode 100644 docs/source/operations/projections/gstmerc.rst create mode 100644 docs/source/operations/projections/hammer.rst create mode 100644 docs/source/operations/projections/hatano.rst create mode 100644 docs/source/operations/projections/healpix.rst create mode 100644 docs/source/operations/projections/igh.rst create mode 100644 docs/source/operations/projections/images/aea.png create mode 100644 docs/source/operations/projections/images/aeqd.png create mode 100644 docs/source/operations/projections/images/airy.png create mode 100644 docs/source/operations/projections/images/aitoff.png create mode 100644 docs/source/operations/projections/images/alsk.png create mode 100644 docs/source/operations/projections/images/apian.png create mode 100644 docs/source/operations/projections/images/august.png create mode 100644 docs/source/operations/projections/images/bacon.png create mode 100644 docs/source/operations/projections/images/bipc.png create mode 100644 docs/source/operations/projections/images/boggs.png create mode 100644 docs/source/operations/projections/images/bonne.png create mode 100644 docs/source/operations/projections/images/calcofi.png create mode 100644 docs/source/operations/projections/images/cass.png create mode 100644 docs/source/operations/projections/images/cc.png create mode 100644 docs/source/operations/projections/images/ccon.png create mode 100644 docs/source/operations/projections/images/cea.png create mode 100644 docs/source/operations/projections/images/chamb.png create mode 100644 docs/source/operations/projections/images/collg.png create mode 100644 docs/source/operations/projections/images/comill.png create mode 100644 docs/source/operations/projections/images/crast.png create mode 100644 docs/source/operations/projections/images/denoy.png create mode 100644 docs/source/operations/projections/images/eck1.png create mode 100644 docs/source/operations/projections/images/eck2.png create mode 100644 docs/source/operations/projections/images/eck3.png create mode 100644 docs/source/operations/projections/images/eck4.png create mode 100644 docs/source/operations/projections/images/eck5.png create mode 100644 docs/source/operations/projections/images/eck6.png create mode 100644 docs/source/operations/projections/images/eqc.png create mode 100644 docs/source/operations/projections/images/eqdc.png create mode 100644 docs/source/operations/projections/images/etmerc.png create mode 100644 docs/source/operations/projections/images/euler.png create mode 100644 docs/source/operations/projections/images/fahey.png create mode 100644 docs/source/operations/projections/images/fouc.png create mode 100644 docs/source/operations/projections/images/fouc_s.png create mode 100644 docs/source/operations/projections/images/gall.png create mode 100644 docs/source/operations/projections/images/geos.png create mode 100644 docs/source/operations/projections/images/gins8.png create mode 100644 docs/source/operations/projections/images/gn_sinu.png create mode 100644 docs/source/operations/projections/images/gnom.png create mode 100644 docs/source/operations/projections/images/goode.png create mode 100644 docs/source/operations/projections/images/gs48.png create mode 100644 docs/source/operations/projections/images/gs50.png create mode 100644 docs/source/operations/projections/images/gstmerc.png create mode 100644 docs/source/operations/projections/images/hammer.png create mode 100644 docs/source/operations/projections/images/hatano.png create mode 100644 docs/source/operations/projections/images/healpix.png create mode 100644 docs/source/operations/projections/images/igh.png create mode 100644 docs/source/operations/projections/images/imw_p.png create mode 100644 docs/source/operations/projections/images/isea.png create mode 100644 docs/source/operations/projections/images/kav5.png create mode 100644 docs/source/operations/projections/images/kav7.png create mode 100644 docs/source/operations/projections/images/krovak.png create mode 100644 docs/source/operations/projections/images/labrd.png create mode 100644 docs/source/operations/projections/images/laea.png create mode 100644 docs/source/operations/projections/images/lagrng.png create mode 100644 docs/source/operations/projections/images/larr.png create mode 100644 docs/source/operations/projections/images/lask.png create mode 100644 docs/source/operations/projections/images/lcc.png create mode 100644 docs/source/operations/projections/images/lcca.png create mode 100644 docs/source/operations/projections/images/leac.png create mode 100644 docs/source/operations/projections/images/lee_os.png create mode 100644 docs/source/operations/projections/images/loxim.png create mode 100644 docs/source/operations/projections/images/lsat.png create mode 100644 docs/source/operations/projections/images/mbt_fps.png create mode 100644 docs/source/operations/projections/images/mbt_s.png create mode 100644 docs/source/operations/projections/images/mbtfpp.png create mode 100644 docs/source/operations/projections/images/mbtfpq.png create mode 100644 docs/source/operations/projections/images/mbtfps.png create mode 100644 docs/source/operations/projections/images/merc.png create mode 100644 docs/source/operations/projections/images/mil_os.png create mode 100644 docs/source/operations/projections/images/mill.png create mode 100644 docs/source/operations/projections/images/misrsom.png create mode 100644 docs/source/operations/projections/images/moll.png create mode 100644 docs/source/operations/projections/images/murd1.png create mode 100644 docs/source/operations/projections/images/murd2.png create mode 100644 docs/source/operations/projections/images/murd3.png create mode 100644 docs/source/operations/projections/images/natearth.png create mode 100644 docs/source/operations/projections/images/natearth2.png create mode 100644 docs/source/operations/projections/images/nell.png create mode 100644 docs/source/operations/projections/images/nell_h.png create mode 100644 docs/source/operations/projections/images/nicol.png create mode 100644 docs/source/operations/projections/images/nsper.png create mode 100644 docs/source/operations/projections/images/nzmg.png create mode 100644 docs/source/operations/projections/images/ob_tran.png create mode 100644 docs/source/operations/projections/images/ocea.png create mode 100644 docs/source/operations/projections/images/oea.png create mode 100644 docs/source/operations/projections/images/omerc.png create mode 100644 docs/source/operations/projections/images/ortel.png create mode 100644 docs/source/operations/projections/images/ortho.png create mode 100644 docs/source/operations/projections/images/patterson.png create mode 100644 docs/source/operations/projections/images/pconic.png create mode 100644 docs/source/operations/projections/images/poly.png create mode 100644 docs/source/operations/projections/images/putp1.png create mode 100644 docs/source/operations/projections/images/putp2.png create mode 100644 docs/source/operations/projections/images/putp3.png create mode 100644 docs/source/operations/projections/images/putp3p.png create mode 100644 docs/source/operations/projections/images/putp4p.png create mode 100644 docs/source/operations/projections/images/putp5.png create mode 100644 docs/source/operations/projections/images/putp5p.png create mode 100644 docs/source/operations/projections/images/putp6.png create mode 100644 docs/source/operations/projections/images/putp6p.png create mode 100644 docs/source/operations/projections/images/qsc.png create mode 100644 docs/source/operations/projections/images/qua_aut.png create mode 100644 docs/source/operations/projections/images/rhealpix.png create mode 100644 docs/source/operations/projections/images/robin.png create mode 100644 docs/source/operations/projections/images/rouss.png create mode 100644 docs/source/operations/projections/images/rpoly.png create mode 100644 docs/source/operations/projections/images/sinu.png create mode 100644 docs/source/operations/projections/images/somerc.png create mode 100644 docs/source/operations/projections/images/stere.png create mode 100644 docs/source/operations/projections/images/sterea.png create mode 100644 docs/source/operations/projections/images/tcc.png create mode 100644 docs/source/operations/projections/images/tcea.png create mode 100644 docs/source/operations/projections/images/tissot.png create mode 100644 docs/source/operations/projections/images/tmerc.png create mode 100644 docs/source/operations/projections/images/tpeqd.png create mode 100644 docs/source/operations/projections/images/tpers.png create mode 100644 docs/source/operations/projections/images/ups.png create mode 100644 docs/source/operations/projections/images/urm5.png create mode 100644 docs/source/operations/projections/images/urmfps.png create mode 100644 docs/source/operations/projections/images/utm.png create mode 100644 docs/source/operations/projections/images/vandg.png create mode 100644 docs/source/operations/projections/images/vandg2.png create mode 100644 docs/source/operations/projections/images/vandg3.png create mode 100644 docs/source/operations/projections/images/vandg4.png create mode 100644 docs/source/operations/projections/images/vitk1.png create mode 100644 docs/source/operations/projections/images/wag1.png create mode 100644 docs/source/operations/projections/images/wag2.png create mode 100644 docs/source/operations/projections/images/wag3.png create mode 100644 docs/source/operations/projections/images/wag4.png create mode 100644 docs/source/operations/projections/images/wag5.png create mode 100644 docs/source/operations/projections/images/wag6.png create mode 100644 docs/source/operations/projections/images/wag7.png create mode 100644 docs/source/operations/projections/images/weren.png create mode 100644 docs/source/operations/projections/images/wink1.png create mode 100644 docs/source/operations/projections/images/wink2.png create mode 100644 docs/source/operations/projections/images/wintri.png create mode 100644 docs/source/operations/projections/imw_p.rst create mode 100644 docs/source/operations/projections/index.rst create mode 100644 docs/source/operations/projections/isea.rst create mode 100644 docs/source/operations/projections/kav5.rst create mode 100644 docs/source/operations/projections/kav7.rst create mode 100644 docs/source/operations/projections/krovak.rst create mode 100644 docs/source/operations/projections/labrd.rst create mode 100644 docs/source/operations/projections/laea.rst create mode 100644 docs/source/operations/projections/lagrng.rst create mode 100644 docs/source/operations/projections/larr.rst create mode 100644 docs/source/operations/projections/lask.rst create mode 100644 docs/source/operations/projections/lcc.rst create mode 100644 docs/source/operations/projections/lcca.rst create mode 100644 docs/source/operations/projections/leac.rst create mode 100644 docs/source/operations/projections/lee_os.rst create mode 100644 docs/source/operations/projections/loxim.rst create mode 100644 docs/source/operations/projections/lsat.rst create mode 100644 docs/source/operations/projections/mbt_fps.rst create mode 100644 docs/source/operations/projections/mbt_s.rst create mode 100644 docs/source/operations/projections/mbtfpp.rst create mode 100644 docs/source/operations/projections/mbtfpq.rst create mode 100644 docs/source/operations/projections/mbtfps.rst create mode 100644 docs/source/operations/projections/merc.rst create mode 100644 docs/source/operations/projections/mil_os.rst create mode 100644 docs/source/operations/projections/mill.rst create mode 100644 docs/source/operations/projections/moll.rst create mode 100644 docs/source/operations/projections/murd1.rst create mode 100644 docs/source/operations/projections/murd2.rst create mode 100644 docs/source/operations/projections/murd3.rst create mode 100644 docs/source/operations/projections/natearth.rst create mode 100644 docs/source/operations/projections/nell.rst create mode 100644 docs/source/operations/projections/nell_h.rst create mode 100644 docs/source/operations/projections/nicol.rst create mode 100644 docs/source/operations/projections/nsper.rst create mode 100644 docs/source/operations/projections/nzmg.rst create mode 100644 docs/source/operations/projections/ob_tran.rst create mode 100644 docs/source/operations/projections/ocea.rst create mode 100644 docs/source/operations/projections/oea.rst create mode 100644 docs/source/operations/projections/omerc.rst create mode 100644 docs/source/operations/projections/ortel.rst create mode 100644 docs/source/operations/projections/ortho.rst create mode 100644 docs/source/operations/projections/pconic.rst create mode 100644 docs/source/operations/projections/poly.rst create mode 100644 docs/source/operations/projections/putp1.rst create mode 100644 docs/source/operations/projections/putp2.rst create mode 100644 docs/source/operations/projections/putp3.rst create mode 100644 docs/source/operations/projections/putp3p.rst create mode 100644 docs/source/operations/projections/putp4p.rst create mode 100644 docs/source/operations/projections/putp5.rst create mode 100644 docs/source/operations/projections/putp5p.rst create mode 100644 docs/source/operations/projections/putp6.rst create mode 100644 docs/source/operations/projections/putp6p.rst create mode 100644 docs/source/operations/projections/qsc.rst create mode 100644 docs/source/operations/projections/qua_aut.rst create mode 100644 docs/source/operations/projections/rhealpix.rst create mode 100644 docs/source/operations/projections/robin.rst create mode 100644 docs/source/operations/projections/rouss.rst create mode 100644 docs/source/operations/projections/rpoly.rst create mode 100644 docs/source/operations/projections/sinu.rst create mode 100644 docs/source/operations/projections/somerc.rst create mode 100644 docs/source/operations/projections/stere.rst create mode 100644 docs/source/operations/projections/sterea.rst create mode 100644 docs/source/operations/projections/tcc.rst create mode 100644 docs/source/operations/projections/tcea.rst create mode 100644 docs/source/operations/projections/tissot.rst create mode 100644 docs/source/operations/projections/tmerc.rst create mode 100644 docs/source/operations/projections/tpeqd.rst create mode 100644 docs/source/operations/projections/tpers.rst create mode 100644 docs/source/operations/projections/ups.rst create mode 100644 docs/source/operations/projections/urm5.rst create mode 100644 docs/source/operations/projections/urmfps.rst create mode 100644 docs/source/operations/projections/utm.rst create mode 100644 docs/source/operations/projections/vandg.rst create mode 100644 docs/source/operations/projections/vandg2.rst create mode 100644 docs/source/operations/projections/vandg3.rst create mode 100644 docs/source/operations/projections/vandg4.rst create mode 100644 docs/source/operations/projections/vitk1.rst create mode 100644 docs/source/operations/projections/wag1.rst create mode 100644 docs/source/operations/projections/wag2.rst create mode 100644 docs/source/operations/projections/wag3.rst create mode 100644 docs/source/operations/projections/wag4.rst create mode 100644 docs/source/operations/projections/wag5.rst create mode 100644 docs/source/operations/projections/wag6.rst create mode 100644 docs/source/operations/projections/wag7.rst create mode 100644 docs/source/operations/projections/weren.rst create mode 100644 docs/source/operations/projections/wink1.rst create mode 100644 docs/source/operations/projections/wink2.rst create mode 100644 docs/source/operations/projections/wintri.rst create mode 100644 docs/source/operations/transformations/deformation.rst create mode 100644 docs/source/operations/transformations/helmert.rst create mode 100644 docs/source/operations/transformations/hgridshift.rst create mode 100644 docs/source/operations/transformations/index.rst create mode 100644 docs/source/operations/transformations/molodensky.rst create mode 100644 docs/source/operations/transformations/vgridshift.rst delete mode 100644 docs/source/usage/operations/conversions/axisswap.rst delete mode 100644 docs/source/usage/operations/conversions/cart.rst delete mode 100644 docs/source/usage/operations/conversions/index.rst delete mode 100644 docs/source/usage/operations/conversions/latlon.rst delete mode 100644 docs/source/usage/operations/conversions/lonlat.rst delete mode 100644 docs/source/usage/operations/conversions/unitconvert.rst delete mode 100644 docs/source/usage/operations/index.rst delete mode 100644 docs/source/usage/operations/pipeline.rst delete mode 100644 docs/source/usage/operations/projections/aeqd.rst delete mode 100644 docs/source/usage/operations/projections/airy.rst delete mode 100644 docs/source/usage/operations/projections/aitoff.rst delete mode 100644 docs/source/usage/operations/projections/alsk.rst delete mode 100644 docs/source/usage/operations/projections/apian.rst delete mode 100644 docs/source/usage/operations/projections/august.rst delete mode 100644 docs/source/usage/operations/projections/bacon.rst delete mode 100644 docs/source/usage/operations/projections/bipc.rst delete mode 100644 docs/source/usage/operations/projections/boggs.rst delete mode 100644 docs/source/usage/operations/projections/bonne.rst delete mode 100644 docs/source/usage/operations/projections/calcofi.rst delete mode 100644 docs/source/usage/operations/projections/cass.rst delete mode 100644 docs/source/usage/operations/projections/cc.rst delete mode 100644 docs/source/usage/operations/projections/ccon.rst delete mode 100644 docs/source/usage/operations/projections/cea.rst delete mode 100644 docs/source/usage/operations/projections/chamb.rst delete mode 100644 docs/source/usage/operations/projections/collg.rst delete mode 100644 docs/source/usage/operations/projections/crast.rst delete mode 100644 docs/source/usage/operations/projections/denoy.rst delete mode 100644 docs/source/usage/operations/projections/eck1.rst delete mode 100644 docs/source/usage/operations/projections/eck2.rst delete mode 100644 docs/source/usage/operations/projections/eck3.rst delete mode 100644 docs/source/usage/operations/projections/eck4.rst delete mode 100644 docs/source/usage/operations/projections/eck5.rst delete mode 100644 docs/source/usage/operations/projections/eck6.rst delete mode 100644 docs/source/usage/operations/projections/eqc.rst delete mode 100644 docs/source/usage/operations/projections/eqdc.rst delete mode 100644 docs/source/usage/operations/projections/etmerc.rst delete mode 100644 docs/source/usage/operations/projections/euler.rst delete mode 100644 docs/source/usage/operations/projections/fahey.rst delete mode 100644 docs/source/usage/operations/projections/fouc.rst delete mode 100644 docs/source/usage/operations/projections/fouc_s.rst delete mode 100644 docs/source/usage/operations/projections/gall.rst delete mode 100644 docs/source/usage/operations/projections/geos.rst delete mode 100644 docs/source/usage/operations/projections/gins8.rst delete mode 100644 docs/source/usage/operations/projections/gn_sinu.rst delete mode 100644 docs/source/usage/operations/projections/gnom.rst delete mode 100644 docs/source/usage/operations/projections/goode.rst delete mode 100644 docs/source/usage/operations/projections/gs48.rst delete mode 100644 docs/source/usage/operations/projections/gs50.rst delete mode 100644 docs/source/usage/operations/projections/gstmerc.rst delete mode 100644 docs/source/usage/operations/projections/hammer.rst delete mode 100644 docs/source/usage/operations/projections/hatano.rst delete mode 100644 docs/source/usage/operations/projections/healpix.rst delete mode 100644 docs/source/usage/operations/projections/igh.rst delete mode 100644 docs/source/usage/operations/projections/images/aea.png delete mode 100644 docs/source/usage/operations/projections/images/aeqd.png delete mode 100644 docs/source/usage/operations/projections/images/airy.png delete mode 100644 docs/source/usage/operations/projections/images/aitoff.png delete mode 100644 docs/source/usage/operations/projections/images/alsk.png delete mode 100644 docs/source/usage/operations/projections/images/apian.png delete mode 100644 docs/source/usage/operations/projections/images/august.png delete mode 100644 docs/source/usage/operations/projections/images/bacon.png delete mode 100644 docs/source/usage/operations/projections/images/bipc.png delete mode 100644 docs/source/usage/operations/projections/images/boggs.png delete mode 100644 docs/source/usage/operations/projections/images/bonne.png delete mode 100644 docs/source/usage/operations/projections/images/calcofi.png delete mode 100644 docs/source/usage/operations/projections/images/cass.png delete mode 100644 docs/source/usage/operations/projections/images/cc.png delete mode 100644 docs/source/usage/operations/projections/images/ccon.png delete mode 100644 docs/source/usage/operations/projections/images/cea.png delete mode 100644 docs/source/usage/operations/projections/images/chamb.png delete mode 100644 docs/source/usage/operations/projections/images/collg.png delete mode 100644 docs/source/usage/operations/projections/images/comill.png delete mode 100644 docs/source/usage/operations/projections/images/crast.png delete mode 100644 docs/source/usage/operations/projections/images/denoy.png delete mode 100644 docs/source/usage/operations/projections/images/eck1.png delete mode 100644 docs/source/usage/operations/projections/images/eck2.png delete mode 100644 docs/source/usage/operations/projections/images/eck3.png delete mode 100644 docs/source/usage/operations/projections/images/eck4.png delete mode 100644 docs/source/usage/operations/projections/images/eck5.png delete mode 100644 docs/source/usage/operations/projections/images/eck6.png delete mode 100644 docs/source/usage/operations/projections/images/eqc.png delete mode 100644 docs/source/usage/operations/projections/images/eqdc.png delete mode 100644 docs/source/usage/operations/projections/images/etmerc.png delete mode 100644 docs/source/usage/operations/projections/images/euler.png delete mode 100644 docs/source/usage/operations/projections/images/fahey.png delete mode 100644 docs/source/usage/operations/projections/images/fouc.png delete mode 100644 docs/source/usage/operations/projections/images/fouc_s.png delete mode 100644 docs/source/usage/operations/projections/images/gall.png delete mode 100644 docs/source/usage/operations/projections/images/geos.png delete mode 100644 docs/source/usage/operations/projections/images/gins8.png delete mode 100644 docs/source/usage/operations/projections/images/gn_sinu.png delete mode 100644 docs/source/usage/operations/projections/images/gnom.png delete mode 100644 docs/source/usage/operations/projections/images/goode.png delete mode 100644 docs/source/usage/operations/projections/images/gs48.png delete mode 100644 docs/source/usage/operations/projections/images/gs50.png delete mode 100644 docs/source/usage/operations/projections/images/gstmerc.png delete mode 100644 docs/source/usage/operations/projections/images/hammer.png delete mode 100644 docs/source/usage/operations/projections/images/hatano.png delete mode 100644 docs/source/usage/operations/projections/images/healpix.png delete mode 100644 docs/source/usage/operations/projections/images/igh.png delete mode 100644 docs/source/usage/operations/projections/images/imw_p.png delete mode 100644 docs/source/usage/operations/projections/images/isea.png delete mode 100644 docs/source/usage/operations/projections/images/kav5.png delete mode 100644 docs/source/usage/operations/projections/images/kav7.png delete mode 100644 docs/source/usage/operations/projections/images/krovak.png delete mode 100644 docs/source/usage/operations/projections/images/labrd.png delete mode 100644 docs/source/usage/operations/projections/images/laea.png delete mode 100644 docs/source/usage/operations/projections/images/lagrng.png delete mode 100644 docs/source/usage/operations/projections/images/larr.png delete mode 100644 docs/source/usage/operations/projections/images/lask.png delete mode 100644 docs/source/usage/operations/projections/images/lcc.png delete mode 100644 docs/source/usage/operations/projections/images/lcca.png delete mode 100644 docs/source/usage/operations/projections/images/leac.png delete mode 100644 docs/source/usage/operations/projections/images/lee_os.png delete mode 100644 docs/source/usage/operations/projections/images/loxim.png delete mode 100644 docs/source/usage/operations/projections/images/lsat.png delete mode 100644 docs/source/usage/operations/projections/images/mbt_fps.png delete mode 100644 docs/source/usage/operations/projections/images/mbt_s.png delete mode 100644 docs/source/usage/operations/projections/images/mbtfpp.png delete mode 100644 docs/source/usage/operations/projections/images/mbtfpq.png delete mode 100644 docs/source/usage/operations/projections/images/mbtfps.png delete mode 100644 docs/source/usage/operations/projections/images/merc.png delete mode 100644 docs/source/usage/operations/projections/images/mil_os.png delete mode 100644 docs/source/usage/operations/projections/images/mill.png delete mode 100644 docs/source/usage/operations/projections/images/misrsom.png delete mode 100644 docs/source/usage/operations/projections/images/moll.png delete mode 100644 docs/source/usage/operations/projections/images/murd1.png delete mode 100644 docs/source/usage/operations/projections/images/murd2.png delete mode 100644 docs/source/usage/operations/projections/images/murd3.png delete mode 100644 docs/source/usage/operations/projections/images/natearth.png delete mode 100644 docs/source/usage/operations/projections/images/natearth2.png delete mode 100644 docs/source/usage/operations/projections/images/nell.png delete mode 100644 docs/source/usage/operations/projections/images/nell_h.png delete mode 100644 docs/source/usage/operations/projections/images/nicol.png delete mode 100644 docs/source/usage/operations/projections/images/nsper.png delete mode 100644 docs/source/usage/operations/projections/images/nzmg.png delete mode 100644 docs/source/usage/operations/projections/images/ob_tran.png delete mode 100644 docs/source/usage/operations/projections/images/ocea.png delete mode 100644 docs/source/usage/operations/projections/images/oea.png delete mode 100644 docs/source/usage/operations/projections/images/omerc.png delete mode 100644 docs/source/usage/operations/projections/images/ortel.png delete mode 100644 docs/source/usage/operations/projections/images/ortho.png delete mode 100644 docs/source/usage/operations/projections/images/patterson.png delete mode 100644 docs/source/usage/operations/projections/images/pconic.png delete mode 100644 docs/source/usage/operations/projections/images/poly.png delete mode 100644 docs/source/usage/operations/projections/images/putp1.png delete mode 100644 docs/source/usage/operations/projections/images/putp2.png delete mode 100644 docs/source/usage/operations/projections/images/putp3.png delete mode 100644 docs/source/usage/operations/projections/images/putp3p.png delete mode 100644 docs/source/usage/operations/projections/images/putp4p.png delete mode 100644 docs/source/usage/operations/projections/images/putp5.png delete mode 100644 docs/source/usage/operations/projections/images/putp5p.png delete mode 100644 docs/source/usage/operations/projections/images/putp6.png delete mode 100644 docs/source/usage/operations/projections/images/putp6p.png delete mode 100644 docs/source/usage/operations/projections/images/qsc.png delete mode 100644 docs/source/usage/operations/projections/images/qua_aut.png delete mode 100644 docs/source/usage/operations/projections/images/rhealpix.png delete mode 100644 docs/source/usage/operations/projections/images/robin.png delete mode 100644 docs/source/usage/operations/projections/images/rouss.png delete mode 100644 docs/source/usage/operations/projections/images/rpoly.png delete mode 100644 docs/source/usage/operations/projections/images/sinu.png delete mode 100644 docs/source/usage/operations/projections/images/somerc.png delete mode 100644 docs/source/usage/operations/projections/images/stere.png delete mode 100644 docs/source/usage/operations/projections/images/sterea.png delete mode 100644 docs/source/usage/operations/projections/images/tcc.png delete mode 100644 docs/source/usage/operations/projections/images/tcea.png delete mode 100644 docs/source/usage/operations/projections/images/tissot.png delete mode 100644 docs/source/usage/operations/projections/images/tmerc.png delete mode 100644 docs/source/usage/operations/projections/images/tpeqd.png delete mode 100644 docs/source/usage/operations/projections/images/tpers.png delete mode 100644 docs/source/usage/operations/projections/images/ups.png delete mode 100644 docs/source/usage/operations/projections/images/urm5.png delete mode 100644 docs/source/usage/operations/projections/images/urmfps.png delete mode 100644 docs/source/usage/operations/projections/images/utm.png delete mode 100644 docs/source/usage/operations/projections/images/vandg.png delete mode 100644 docs/source/usage/operations/projections/images/vandg2.png delete mode 100644 docs/source/usage/operations/projections/images/vandg3.png delete mode 100644 docs/source/usage/operations/projections/images/vandg4.png delete mode 100644 docs/source/usage/operations/projections/images/vitk1.png delete mode 100644 docs/source/usage/operations/projections/images/wag1.png delete mode 100644 docs/source/usage/operations/projections/images/wag2.png delete mode 100644 docs/source/usage/operations/projections/images/wag3.png delete mode 100644 docs/source/usage/operations/projections/images/wag4.png delete mode 100644 docs/source/usage/operations/projections/images/wag5.png delete mode 100644 docs/source/usage/operations/projections/images/wag6.png delete mode 100644 docs/source/usage/operations/projections/images/wag7.png delete mode 100644 docs/source/usage/operations/projections/images/weren.png delete mode 100644 docs/source/usage/operations/projections/images/wink1.png delete mode 100644 docs/source/usage/operations/projections/images/wink2.png delete mode 100644 docs/source/usage/operations/projections/images/wintri.png delete mode 100644 docs/source/usage/operations/projections/imw_p.rst delete mode 100644 docs/source/usage/operations/projections/index.rst delete mode 100644 docs/source/usage/operations/projections/isea.rst delete mode 100644 docs/source/usage/operations/projections/kav5.rst delete mode 100644 docs/source/usage/operations/projections/kav7.rst delete mode 100644 docs/source/usage/operations/projections/krovak.rst delete mode 100644 docs/source/usage/operations/projections/labrd.rst delete mode 100644 docs/source/usage/operations/projections/laea.rst delete mode 100644 docs/source/usage/operations/projections/lagrng.rst delete mode 100644 docs/source/usage/operations/projections/larr.rst delete mode 100644 docs/source/usage/operations/projections/lask.rst delete mode 100644 docs/source/usage/operations/projections/lcc.rst delete mode 100644 docs/source/usage/operations/projections/lcca.rst delete mode 100644 docs/source/usage/operations/projections/leac.rst delete mode 100644 docs/source/usage/operations/projections/lee_os.rst delete mode 100644 docs/source/usage/operations/projections/loxim.rst delete mode 100644 docs/source/usage/operations/projections/lsat.rst delete mode 100644 docs/source/usage/operations/projections/mbt_fps.rst delete mode 100644 docs/source/usage/operations/projections/mbt_s.rst delete mode 100644 docs/source/usage/operations/projections/mbtfpp.rst delete mode 100644 docs/source/usage/operations/projections/mbtfpq.rst delete mode 100644 docs/source/usage/operations/projections/mbtfps.rst delete mode 100644 docs/source/usage/operations/projections/merc.rst delete mode 100644 docs/source/usage/operations/projections/mil_os.rst delete mode 100644 docs/source/usage/operations/projections/mill.rst delete mode 100644 docs/source/usage/operations/projections/moll.rst delete mode 100644 docs/source/usage/operations/projections/murd1.rst delete mode 100644 docs/source/usage/operations/projections/murd2.rst delete mode 100644 docs/source/usage/operations/projections/murd3.rst delete mode 100644 docs/source/usage/operations/projections/natearth.rst delete mode 100644 docs/source/usage/operations/projections/nell.rst delete mode 100644 docs/source/usage/operations/projections/nell_h.rst delete mode 100644 docs/source/usage/operations/projections/nicol.rst delete mode 100644 docs/source/usage/operations/projections/nsper.rst delete mode 100644 docs/source/usage/operations/projections/nzmg.rst delete mode 100644 docs/source/usage/operations/projections/ob_tran.rst delete mode 100644 docs/source/usage/operations/projections/ocea.rst delete mode 100644 docs/source/usage/operations/projections/oea.rst delete mode 100644 docs/source/usage/operations/projections/omerc.rst delete mode 100644 docs/source/usage/operations/projections/ortel.rst delete mode 100644 docs/source/usage/operations/projections/ortho.rst delete mode 100644 docs/source/usage/operations/projections/pconic.rst delete mode 100644 docs/source/usage/operations/projections/poly.rst delete mode 100644 docs/source/usage/operations/projections/putp1.rst delete mode 100644 docs/source/usage/operations/projections/putp2.rst delete mode 100644 docs/source/usage/operations/projections/putp3.rst delete mode 100644 docs/source/usage/operations/projections/putp3p.rst delete mode 100644 docs/source/usage/operations/projections/putp4p.rst delete mode 100644 docs/source/usage/operations/projections/putp5.rst delete mode 100644 docs/source/usage/operations/projections/putp5p.rst delete mode 100644 docs/source/usage/operations/projections/putp6.rst delete mode 100644 docs/source/usage/operations/projections/putp6p.rst delete mode 100644 docs/source/usage/operations/projections/qsc.rst delete mode 100644 docs/source/usage/operations/projections/qua_aut.rst delete mode 100644 docs/source/usage/operations/projections/rhealpix.rst delete mode 100644 docs/source/usage/operations/projections/robin.rst delete mode 100644 docs/source/usage/operations/projections/rouss.rst delete mode 100644 docs/source/usage/operations/projections/rpoly.rst delete mode 100644 docs/source/usage/operations/projections/sinu.rst delete mode 100644 docs/source/usage/operations/projections/somerc.rst delete mode 100644 docs/source/usage/operations/projections/stere.rst delete mode 100644 docs/source/usage/operations/projections/sterea.rst delete mode 100644 docs/source/usage/operations/projections/tcc.rst delete mode 100644 docs/source/usage/operations/projections/tcea.rst delete mode 100644 docs/source/usage/operations/projections/tissot.rst delete mode 100644 docs/source/usage/operations/projections/tmerc.rst delete mode 100644 docs/source/usage/operations/projections/tpeqd.rst delete mode 100644 docs/source/usage/operations/projections/tpers.rst delete mode 100644 docs/source/usage/operations/projections/ups.rst delete mode 100644 docs/source/usage/operations/projections/urm5.rst delete mode 100644 docs/source/usage/operations/projections/urmfps.rst delete mode 100644 docs/source/usage/operations/projections/utm.rst delete mode 100644 docs/source/usage/operations/projections/vandg.rst delete mode 100644 docs/source/usage/operations/projections/vandg2.rst delete mode 100644 docs/source/usage/operations/projections/vandg3.rst delete mode 100644 docs/source/usage/operations/projections/vandg4.rst delete mode 100644 docs/source/usage/operations/projections/vitk1.rst delete mode 100644 docs/source/usage/operations/projections/wag1.rst delete mode 100644 docs/source/usage/operations/projections/wag2.rst delete mode 100644 docs/source/usage/operations/projections/wag3.rst delete mode 100644 docs/source/usage/operations/projections/wag4.rst delete mode 100644 docs/source/usage/operations/projections/wag5.rst delete mode 100644 docs/source/usage/operations/projections/wag6.rst delete mode 100644 docs/source/usage/operations/projections/wag7.rst delete mode 100644 docs/source/usage/operations/projections/weren.rst delete mode 100644 docs/source/usage/operations/projections/wink1.rst delete mode 100644 docs/source/usage/operations/projections/wink2.rst delete mode 100644 docs/source/usage/operations/projections/wintri.rst delete mode 100644 docs/source/usage/operations/transformations/deformation.rst delete mode 100644 docs/source/usage/operations/transformations/helmert.rst delete mode 100644 docs/source/usage/operations/transformations/hgridshift.rst delete mode 100644 docs/source/usage/operations/transformations/index.rst delete mode 100644 docs/source/usage/operations/transformations/molodensky.rst delete mode 100644 docs/source/usage/operations/transformations/vgridshift.rst (limited to 'docs/source') diff --git a/docs/source/index.rst b/docs/source/index.rst index c627ae6d..7f7e8365 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -35,6 +35,7 @@ Documentation :maxdepth: 1 usage/index + operations/index resource_files geodesic development/index diff --git a/docs/source/operations/conversions/axisswap.rst b/docs/source/operations/conversions/axisswap.rst new file mode 100644 index 00000000..ddaad075 --- /dev/null +++ b/docs/source/operations/conversions/axisswap.rst @@ -0,0 +1,39 @@ +.. _axisswap: + +================================================================================ +Axis swap +================================================================================ + +Change the order and sign of 2,3 or 4 axes. + ++--------------+---------------------------------------------------------------+ +| **Options** | ++--------------+---------------------------------------------------------------+ +| `+order` | Ordered comma-separated list of axis, e.g. `+order=2,1,3,4` | ++--------------+---------------------------------------------------------------+ + + +Each of the possible four axes are numbered with 1-4, such that the first input axis +is 1, the second is 2 and so on. The output ordering is controlled by a list of the +input axes re-ordered to the new mapping. + +Examples +################################################################################ + +Reversing the order of the axes:: + + +proj=axisswap +order=4,3,2,1 + +Swapping the first two axes (x and y):: + + +proj=axisswap +order=2,1,3,4 + +The direction, or sign, of an axis can be changed by adding a minus in +front of the axis-number:: + + +proj=axisswap +order=1,-2,3,4 + +It is only necessary to specify the axes that are affected by the swap +operation:: + + +proj=axisswap +order=2,1 diff --git a/docs/source/operations/conversions/cart.rst b/docs/source/operations/conversions/cart.rst new file mode 100644 index 00000000..0c3c7c23 --- /dev/null +++ b/docs/source/operations/conversions/cart.rst @@ -0,0 +1,24 @@ +.. _cart: + +================================================================================ +Cartesian to geodetic conversion +================================================================================ + +Convert geodetic coordinates to cartesian coordinates. + ++--------------+--------------------------------------------------------------------+ +| **Options** | ++--------------+--------------------------------------------------------------------+ +| `+ellps` | Ellipsoid of the input coordinates. If used together with the | +| |  ellipsoid parameters below, ``+ellps`` is overwritten. | ++--------------+--------------------------------------------------------------------+ +| `+a` | Semi-major radius of ellipsoid axis. | ++--------------+--------------------------------------------------------------------+ +| `+b` | Semi-minor radius of ellipsoid axis. | ++--------------+--------------------------------------------------------------------+ +| `+es` | Eccentricity of ellipsoid. | ++--------------+--------------------------------------------------------------------+ +| `+f` | Flattening of ellipsoid. | ++--------------+--------------------------------------------------------------------+ + + diff --git a/docs/source/operations/conversions/index.rst b/docs/source/operations/conversions/index.rst new file mode 100644 index 00000000..af27e2fd --- /dev/null +++ b/docs/source/operations/conversions/index.rst @@ -0,0 +1,18 @@ +.. _conversions_list: + +================================================================================ +Conversions +================================================================================ + +Conversions are coordinate operations in which both coordinate reference systems +are based on the same datum. In PROJ projections are differentiated from +conversions. + +.. toctree:: + :maxdepth: 1 + + axisswap + cart + lonlat + latlon + unitconvert diff --git a/docs/source/operations/conversions/latlon.rst b/docs/source/operations/conversions/latlon.rst new file mode 100644 index 00000000..6712fa7b --- /dev/null +++ b/docs/source/operations/conversions/latlon.rst @@ -0,0 +1,6 @@ +.. _latlon: + +******************************************************************************** +Lat/long (Geodetic alias) +******************************************************************************** + diff --git a/docs/source/operations/conversions/lonlat.rst b/docs/source/operations/conversions/lonlat.rst new file mode 100644 index 00000000..589cc813 --- /dev/null +++ b/docs/source/operations/conversions/lonlat.rst @@ -0,0 +1,6 @@ +.. _lonlat: + +******************************************************************************** +Lat/long (Geodetic) +******************************************************************************** + diff --git a/docs/source/operations/conversions/unitconvert.rst b/docs/source/operations/conversions/unitconvert.rst new file mode 100644 index 00000000..73e517bd --- /dev/null +++ b/docs/source/operations/conversions/unitconvert.rst @@ -0,0 +1,112 @@ +.. _unitconvert: + +================================================================================ +Unit conversion +================================================================================ + +Convert between various distance and time units. + ++--------------+--------------------------------------------------------------------+ +| **Options** | ++--------------+--------------------------------------------------------------------+ +| `+xy_in` | Input unit of the horizontal components. | ++--------------+--------------------------------------------------------------------+ +| `+xy_out` | Output unit of the horizontal components. | ++--------------+--------------------------------------------------------------------+ +| `+z_in` | Input unit of the vertical component. | ++--------------+--------------------------------------------------------------------+ +| `+z_out` | Output unit of the vertical component. | ++--------------+--------------------------------------------------------------------+ +| `+t_in` | Input unit of the time component. | ++--------------+--------------------------------------------------------------------+ +| `+t_out` | Output unit of the time component. | ++--------------+--------------------------------------------------------------------+ + +There are many examples of coordinate reference systems that are expressed in +other units than the meter. There are also many cases where temporal data +has to be translated to different units. The `unitconvert` operation takes care +of that. + +Many North American systems are defined with coordinates in feet. For example +in Vermont:: + + +proj=pipeline + +step +proj=tmerc +lat_0=42.5 +lon_0=-72.5 +k=0.999964286 +x_0=500000.00001016 +y_0=0 + +step +proj=unitconvert +xy_in=m +xy_out=us-ft + +Often when working with GNNS data the timestamps are presented in GPS-weeks, +but when the data transformed with the `helmert` operation timestamps are +expected to be in units of decimalyears. This can be fixed with `unitconvert`:: + + +proj=pipeline + +step +proj=unitconvert +t_in=gpsweek +t_out=decimalyear + +step +proj=helmert +epoch=2000.0 +t_obs=2017.5 ... + + +Distance units +############################################################################### + +In the table below all distance units supported by PROJ is listed. +The same list can also be produced on the command line with `proj` or `cs2cs`, +by adding the `-lu` flag when calling the utility. + ++----------+---------------------------------+ +| Label | Name | ++----------+---------------------------------+ +| km | Kilometer | ++----------+---------------------------------+ +| m | Meter | ++----------+---------------------------------+ +| dm | Decimeter | ++----------+---------------------------------+ +| cm | Centimeter | ++----------+---------------------------------+ +| mm | Millimeter | ++----------+---------------------------------+ +| kmi | International Nautical Mile | ++----------+---------------------------------+ +| in | International Inch | ++----------+---------------------------------+ +| ft | International Foot | ++----------+---------------------------------+ +| yd | International Yard | ++----------+---------------------------------+ +| mi | International Statute Mile | ++----------+---------------------------------+ +| fath | International Fathom | ++----------+---------------------------------+ +| ch | International Chain | ++----------+---------------------------------+ +| link | International Link | ++----------+---------------------------------+ +| us-in | U.S. Surveyor's Inch | ++----------+---------------------------------+ +| us-ft | U.S. Surveyor's Foot | ++----------+---------------------------------+ +| us-yd | U.S. Surveyor's Yard | ++----------+---------------------------------+ +| us-ch | U.S. Surveyor's Chain | ++----------+---------------------------------+ +| us-mi | U.S. Surveyor's Statute Mile | ++----------+---------------------------------+ +| ind-yd | Indian Yard | ++----------+---------------------------------+ +| ind-ft | Indian Foot | ++----------+---------------------------------+ +| ind-ch | Indian Chain | ++----------+---------------------------------+ + + +Time units +############################################################################### + +In the table below all time units supported by PROJ is listed. + ++--------------+-----------------------------+ +| mjd | Modfied Julian date | ++--------------+-----------------------------+ +| decimalyear | Decimal year | ++--------------+-----------------------------+ +| gps_week | GPS Week | ++--------------+-----------------------------+ + diff --git a/docs/source/operations/index.rst b/docs/source/operations/index.rst new file mode 100644 index 00000000..87bfdc40 --- /dev/null +++ b/docs/source/operations/index.rst @@ -0,0 +1,22 @@ +.. _operations: + +================================================================================ +Coordinate operations +================================================================================ + +Coordinate operations in PROJ are divided into three groups: +Projections, conversions and transformations. +Projections are purely cartographic mappings of the sphere onto the plane. +Technically projections are conversions (according to ISO standards), though in +PROJ projections are distinguished from conversions. Conversions are coordinate +operations that do not exert a change in reference frame. Operations that do +exert a change in reference frame are called transformations. + +.. toctree:: + :maxdepth: 1 + + projections/index + conversions/index + transformations/index + pipeline + diff --git a/docs/source/operations/pipeline.rst b/docs/source/operations/pipeline.rst new file mode 100644 index 00000000..18637712 --- /dev/null +++ b/docs/source/operations/pipeline.rst @@ -0,0 +1,98 @@ +.. _pipeline: + +================================================================================ +The pipeline operator +================================================================================ + +Construct complex operations by daisy-chaining operations in a sequential pipeline. + ++-----------------+--------------------------------------------------------------------+ +| **Input type** | Any. | ++-----------------+--------------------------------------------------------------------+ +| **Output type** | Any. | ++-----------------+--------------------------------------------------------------------+ +| **Options** | ++-----------------+--------------------------------------------------------------------+ +| `step` | Separate each step in a pipeline. | ++-----------------+--------------------------------------------------------------------+ +| `inv` | Invert a step in a pipeline. | ++-----------------+--------------------------------------------------------------------+ + +.. note:: See the section on :ref:`transformation` for a more thorough introduction + to the concept of transformation pipelines in PROJ. + + +With the pipeline operation it is possible to perform several operations after each +other on the same input data. This feature makes it possible to create transformations +that are made up of more than one operation, e.g. performing a datum shift and then +applying a suitable map projection. Theoretically any transformation between two +coordinate reference systems is possible to perform using the pipeline operation, +provided that the necessary coordinate operations in each step is available in PROJ. + +A pipeline is made up of a number of steps, with each step being a coordinate operation +in itself. By connecting these individual steps sequentially we end up with a concatenated +coordinate operation. An example of this is a transformation from geodetic coordinates +on the GRS80 ellipsoid to a projected system where the east-west and north-east axes has +been swapped: + +:: + + +proj=pipeline +ellps=GRS80 +step +proj=merc +step +proj=axisswap +order=2,1 + +Here the first step is applying the :ref:`merc` projection and the second step is +applying the :ref:`axisswap` conversion. Note that the `+ellps=GRS80` is specified +before the first occurence of `+step`. This means that the GRS80 ellipsoid is used +in both steps, since any parameter stated before the first occurence of `+step` is +treated as a global parameter and is transferred to each individual steps. + + +Rules for pipelines +------------------------------------------------------------------------------- + +**1. Pipelines must consist of at least one step.** + +:: + + +proj=pipeline + +Will result in an error. + +**2. Pipelines can only be nested if the nested pipeline is defined in an init-file.** + +:: + + +proj=pipeline + +step +proj=pipeline +step +proj=merc +step +proj=axisswap +order=2,1 + +step +proj=unitconvert +xy_in=m +xy_out=us-ft + +Results in an error, while + +:: + + +proj=pipeline + +step +init=predefined_pipelines:projectandswap + +step +proj=unitconvert +xy_in=m +xy_out=us-ft + +does not. + +**3. Pipelines without a forward path can't be constructed.** + +:: + + +proj=pipeline +step +inv +proj=urm5 + +Will result in an error since :ref:`urm5` does not have an inverse operation defined. + +**4. Parameters added before the first `+step` are global and will be applied to all steps.** + +In the following the GRS80 ellipsoid will be applied to all steps. + +:: + + +proj=pipeline +ellps=GRS80 + +step +proj=cart + +step +proj=helmert +x=10 +y=3 +z=1 + +step +proj=cart +inv + +step +proj=merc + + diff --git a/docs/source/operations/projections/aeqd.rst b/docs/source/operations/projections/aeqd.rst new file mode 100644 index 00000000..32165e49 --- /dev/null +++ b/docs/source/operations/projections/aeqd.rst @@ -0,0 +1,22 @@ +.. _aeqd: + +******************************************************************************** +Azimuthal Equidistant +******************************************************************************** ++---------------------+----------------------------------------------------------+ +| **Classification** | Azimuthal | ++---------------------+----------------------------------------------------------+ +| **Available forms** | Forward and inverse, spherical and elliptical projection | ++---------------------+----------------------------------------------------------+ +| **Implemented by** | Gerald I. Evenden | ++---------------------+----------------------------------------------------------+ +| **Options** | ++---------------------+----------------------------------------------------------+ +| `+guam` | Use Guam elliptical formulas. Defaults to false. | ++---------------------+----------------------------------------------------------+ + + +.. image:: ./images/aeqd.png + :scale: 50% + :alt: Azimuthal Equidistant + diff --git a/docs/source/operations/projections/airy.rst b/docs/source/operations/projections/airy.rst new file mode 100644 index 00000000..d2730592 --- /dev/null +++ b/docs/source/operations/projections/airy.rst @@ -0,0 +1,26 @@ +.. _airy: + +******************************************************************************** +Airy +******************************************************************************** ++---------------------+----------------------------------------------------------+ +| **Classification** | | ++---------------------+----------------------------------------------------------+ +| **Available forms** | Forward spherical projection | ++---------------------+----------------------------------------------------------+ +| **Defined area** | Global | ++---------------------+----------------------------------------------------------+ +| **Implemented by** | Gerald I. Evenden | ++---------------------+----------------------------------------------------------+ +| **Options** | ++---------------------+----------------------------------------------------------+ +| `+lat_b` | | ++---------------------+----------------------------------------------------------+ +| `+no_cut` | Do not cut at hemisphere limit | ++---------------------+----------------------------------------------------------+ + + +.. image:: ./images/airy.png + :scale: 50% + :alt: Airy + diff --git a/docs/source/operations/projections/aitoff.rst b/docs/source/operations/projections/aitoff.rst new file mode 100644 index 00000000..4d681468 --- /dev/null +++ b/docs/source/operations/projections/aitoff.rst @@ -0,0 +1,10 @@ +.. _aitoff: + +******************************************************************************** +Aitoff +******************************************************************************** + +.. image:: ./images/aitoff.png + :scale: 50% + :alt: Aitoff + diff --git a/docs/source/operations/projections/alsk.rst b/docs/source/operations/projections/alsk.rst new file mode 100644 index 00000000..f7a7a0ef --- /dev/null +++ b/docs/source/operations/projections/alsk.rst @@ -0,0 +1,10 @@ +.. _alsk: + +******************************************************************************** +Mod. Stererographics of Alaska +******************************************************************************** + +.. image:: ./images/alsk.png + :scale: 50% + :alt: Mod. Stererographics of Alaska + diff --git a/docs/source/operations/projections/apian.rst b/docs/source/operations/projections/apian.rst new file mode 100644 index 00000000..add501ea --- /dev/null +++ b/docs/source/operations/projections/apian.rst @@ -0,0 +1,10 @@ +.. _apian: + +******************************************************************************** +Apian Globular I +******************************************************************************** + +.. image:: ./images/apian.png + :scale: 50% + :alt: Apian Globular I + diff --git a/docs/source/operations/projections/august.rst b/docs/source/operations/projections/august.rst new file mode 100644 index 00000000..e2ad3516 --- /dev/null +++ b/docs/source/operations/projections/august.rst @@ -0,0 +1,10 @@ +.. _august: + +******************************************************************************** +August Epicycloidal +******************************************************************************** + +.. image:: ./images/august.png + :scale: 50% + :alt: August Epicycloidal + diff --git a/docs/source/operations/projections/bacon.rst b/docs/source/operations/projections/bacon.rst new file mode 100644 index 00000000..a87ea7d8 --- /dev/null +++ b/docs/source/operations/projections/bacon.rst @@ -0,0 +1,10 @@ +.. _bacon: + +******************************************************************************** +Bacon Globular +******************************************************************************** + +.. image:: ./images/bacon.png + :scale: 50% + :alt: Bacon Globular + diff --git a/docs/source/operations/projections/bipc.rst b/docs/source/operations/projections/bipc.rst new file mode 100644 index 00000000..7045f04a --- /dev/null +++ b/docs/source/operations/projections/bipc.rst @@ -0,0 +1,10 @@ +.. _bipc: + +******************************************************************************** +Bipolar conic of western hemisphere +******************************************************************************** + +.. image:: ./images/bipc.png + :scale: 50% + :alt: Bipolar conic of western hemisphere + diff --git a/docs/source/operations/projections/boggs.rst b/docs/source/operations/projections/boggs.rst new file mode 100644 index 00000000..1dd7d19f --- /dev/null +++ b/docs/source/operations/projections/boggs.rst @@ -0,0 +1,10 @@ +.. _boggs: + +******************************************************************************** +Boggs Eumorphic +******************************************************************************** + +.. image:: ./images/boggs.png + :scale: 50% + :alt: Boggs Eumorphic + diff --git a/docs/source/operations/projections/bonne.rst b/docs/source/operations/projections/bonne.rst new file mode 100644 index 00000000..ef87d7c9 --- /dev/null +++ b/docs/source/operations/projections/bonne.rst @@ -0,0 +1,10 @@ +.. _bonne: + +******************************************************************************** +Bonne (Werner lat_1=90) +******************************************************************************** + +.. image:: ./images/bonne.png + :scale: 50% + :alt: Bonne (Werner lat_1=90) + diff --git a/docs/source/operations/projections/calcofi.rst b/docs/source/operations/projections/calcofi.rst new file mode 100644 index 00000000..4a29c812 --- /dev/null +++ b/docs/source/operations/projections/calcofi.rst @@ -0,0 +1,95 @@ +.. _calcofi: + +******************************************************************************** +Cal Coop Ocean Fish Invest Lines/Stations +******************************************************************************** + +The CalCOFI pseudo-projection is the line and station coordinate system of the +California Cooperative Oceanic Fisheries Investigations program, known as CalCOFI, for sampling offshore of the west coast of the U.S. and Mexico. + ++---------------------+----------------------------------------------------------+ +| **Classification** | Conformal cylindrical | ++---------------------+----------------------------------------------------------+ +| **Available forms** | Forward and inverse, spherical and elliptical projection | ++---------------------+----------------------------------------------------------+ +| **Defined area** | Only valid for the west coast of USA and Mexico | ++---------------------+----------------------------------------------------------+ +| **Implemented by** | Frank Warmerdam | ++---------------------+----------------------------------------------------------+ +| **Options** | ++---------------------+----------------------------------------------------------+ +| `No special options for this projection` | ++---------------------+----------------------------------------------------------+ + + +.. image:: ../../../images/calcofi.png + :scale: 50% + :align: center + :alt: Cal Coop Ocean Fish Invest Lines/Stations + +The coordinate system is based on the Mercator projection with units rotated -30 +degrees from the meridian so that they are oriented with the coastline of the Southern California Bight and Baja California. +Lines increase from Northwest to Southeast. +A unit of line is 12 nautical miles. Stations increase from inshore to offshore. +A unit of station is equal to 4 nautical miles. +The rotation point is located at line 80, station 60, or 34.15 degrees N, -121.15 degrees W, and is depicted by the red dot in the figure. +By convention, the ellipsoid of Clarke 1866 is used to calculate CalCOFI coordinates. + +The CalCOFI program is a joint research effort by the U.S. National Oceanic and +Atmospheric Administration, University of California Scripps Oceanographic Institute, and California Department of Fish and Game. +Surveys have been conducted for the CalCOFI program since 1951, creating one of the oldest and most scientifically valuable joint oceanographic and fisheries data sets in the world. +The CalCOFI line and station coordinate system is now used by several other programs including the Investigaciones Mexicanas de la Corriente de California (IMECOCAL) program offshore of Baja California. +The figure depicts some commonly sampled locations from line 40 to line 156.7 and offshore to station 120. Blue numbers indicate line (bottom) or station (left) numbers along the grid. Note that lines spaced at approximate 3-1/3 intervals are commonly sampled, e.g., lines 43.3 and 46.7. + +Usage +############################################################################### + +A typical forward CalCOFI projection would be from lon/lat coordinates on the +Clark 1866 ellipsoid. +For example:: + + proj +proj=calcofi +ellps=clrk66 -E <`_ +#. `The Investigaciones Mexicanas de la Corriente de California `_ + + + + + + + + + + + + + + diff --git a/docs/source/operations/projections/cass.rst b/docs/source/operations/projections/cass.rst new file mode 100644 index 00000000..4111a2ee --- /dev/null +++ b/docs/source/operations/projections/cass.rst @@ -0,0 +1,145 @@ +.. _cass: + +******************************************************************************** +Cassini (Cassini-Soldner) +******************************************************************************** + +Although the Cassini projection has been largely replaced by the Transverse Mercator, it is still in limited use outside the United States and was one of the major topographic mapping projections until the early 20th century. + ++---------------------+-------------------------------------------------------------------------+ +| **Classification** | Transverse and oblique cylindrical | ++---------------------+-------------------------------------------------------------------------+ +| **Available forms** | Forward and inverse, Spherical and Elliptical | ++---------------------+-------------------------------------------------------------------------+ +| **Defined area** | Global, but best used near the central meridian with long, narrow areas | ++---------------------+-------------------------------------------------------------------------+ +| **Implemented by** | Gerald I. Evenden | ++---------------------+-------------------------------------------------------------------------+ +| **Options** | ++---------------------+-------------------------------------------------------------------------+ +| `+lat_0` | Latitude of origin (Default to 0) | ++---------------------+-------------------------------------------------------------------------+ + +.. image:: ./images/cass.png + :scale: 50% + :alt: Cassini + +Usage +##### + +There has been little usage of the spherical version of the Cassini, but the ellipsoidal Cassini-Soldner version was adopted by the Ordnance Survey for the official survey of Great Britain during the second half of the 19th century [Steers1970]_. +Many of these maps were prepared at a scale of 1:2,500. +The Cassini-Soldner was also used for the detailed mapping of many German states during the same period. + + +Example using EPSG 30200 (Trinidad 1903, units in clarke's links):: + + $ echo 0.17453293 -1.08210414 | proj +proj=cass +lat_0=10.44166666666667 +lon_0=-61.33333333333334 +x_0=86501.46392051999 +y_0=65379.0134283 +a=6378293.645208759 +b=6356617.987679838 +to_meter=0.201166195164 +no_defs + 66644.94 82536.22 + +Example using EPSG 3068 (Soldner Berlin):: + + $ echo 13.5 52.4 | proj +proj=cass +lat_0=52.41864827777778 +lon_0=13.62720366666667 +x_0=40000 +y_0=10000 +ellps=bessel +datum=potsdam +units=m +no_defs + 31343.05 7932.76 + + +Mathematical definition +####################### + +The formulas describing the Cassini projection are taken from Snyder's [Snyder1987]_. + +:math:`\phi_0` is the latitude of origin that match the center of the map (default to 0). It can be set with ``+lat_0``. + + +Spherical form +============== + +Forward projection +------------------ + +.. math:: + + x = \arcsin(\cos(\phi) \sin(\lambda)) + +.. math:: + + y = \arctan2(\tan(\phi), \cos(\lambda)) - \phi_0 + +Inverse projection +------------------ + +.. math:: + + \phi = \arcsin(\sin(y+\phi_0) \cos(x)) + +.. math:: + + \lambda = \arctan2(\tan(x), \cos(y+\phi_0)) + +Elliptical form +=============== + +Forward projection +------------------ + +.. math:: + + N = (1 - e^2 \sin^2(\phi))^{-1/2} + +.. math:: + + T = \tan^2(\phi) + +.. math:: + + A = \lambda \cos(\phi) + +.. math:: + + C = \frac{e^2}{1-e^2} cos^2(\phi) + +.. math:: + + x = N ( A - T \frac{A^3}{6} - (8-T+8C)T\frac{A^5}{120}) + +.. math:: + + y = M(\phi) - M(\phi_0) + N \tan(\phi)(\frac{A^2}{2} + (5-T+6C)\frac{A^4}{24}) + +and M() is the meridional distance function. + +Inverse projection +------------------ + +.. math:: + + \phi' = M^{-1}(M(\phi_0)+y) + +if :math:`\phi' = \frac{\pi}{2}` then :math:`\phi=\phi'` and :math:`\lambda=0` + +otherwise evaluate T and N above using :math:`\phi'` and + +.. math:: + + R = (1 - e^2)(1 - e^2 sin^2 \phi')^{-3/2} + +.. math:: + + D = x/N + +.. math:: + + \phi = \phi' - \tan \phi' \frac{N}{R}(\frac{D^2}{2}-(1+3T)\frac{D^4}{24}) + +.. math:: + + \lambda = \frac{(D - T\frac{D^3}{3} + (1+3T)T\frac{D^5}{15})}{\cos \phi'} + +.. _further-reading: + +Further reading +############### + +#. `Wikipedia `_ +#. [Snyder1987]_ +#. `EPSG, POSC literature pertaining to Coordinate Conversions and Transformations including Formulas `_ diff --git a/docs/source/operations/projections/cc.rst b/docs/source/operations/projections/cc.rst new file mode 100644 index 00000000..5b30e6c6 --- /dev/null +++ b/docs/source/operations/projections/cc.rst @@ -0,0 +1,10 @@ +.. _cc: + +******************************************************************************** +Central Cylindrical +******************************************************************************** + +.. image:: ./images/cc.png + :scale: 50% + :alt: Central Cylindrical + diff --git a/docs/source/operations/projections/ccon.rst b/docs/source/operations/projections/ccon.rst new file mode 100644 index 00000000..8a858e38 --- /dev/null +++ b/docs/source/operations/projections/ccon.rst @@ -0,0 +1,127 @@ +.. _ccon: + +******************************************************************************** +Central Conic +******************************************************************************** + +This is central (centrographic) projection on cone tangent at ``lat_0`` latitude, +identical with ``conic()`` projection from ``mapproj`` R package. + ++---------------------+----------------------------------------------------------+ +| **Classification** | Conic | ++---------------------+----------------------------------------------------------+ +| **Available forms** | Forward and inverse, spherical projection | ++---------------------+----------------------------------------------------------+ +| **Defined area** | Global, but best used near the standard parallel | ++---------------------+----------------------------------------------------------+ +| **Implemented by** | Lukasz Komsta | ++---------------------+----------------------------------------------------------+ +| **Options** | ++---------------------+----------------------------------------------------------+ +| `+lat_1` | Latitude of standard parallel. | ++---------------------+----------------------------------------------------------+ + +.. image:: ./images/ccon.png + :scale: 50% + :alt: Central Conic + + +Usage +######## + +This simple projection is rarely used, as it is not equidistant, equal-area, nor +conformal. + +An example of usage (and the main reason to implement this projection in proj4) +is the ATPOL geobotanical grid of Poland, developed in Institute of Botany, +Jagiellonian University, Krakow, Poland in 1970s [Zajac1978]_. The grid was +originally handwritten on paper maps and further copied by hand. The projection +(together with strange Earth radius) was chosen by its creators as the compromise +fit to existing maps during first software development in DOS era. Many years later +it is still de facto standard grid in Polish geobotanical research. + +The ATPOL coordinates can be achieved with with the following parameters: + +:: + + +proj=ccon +lat_1=52 +lat_0=52 +lon_0=19 +axis=esu +a=6390000 +x_0=330000 +y_0=-350000 + +For more information see [Komsta2016]_ and [Verey2017]_. + + +Forward projection +================== + +.. math:: + + r = \cot \phi_0 - \tan (\phi - \phi_0) + +.. math:: + + x = r \sin (\lambda\sin\phi_0) + +.. math:: + + y = \cot \phi_0 - r \cos (\lambda\sin\phi_0) + + +Inverse projection +================== + +.. math:: + + y = \cot \phi_0 - y + +.. math:: + + \phi = \phi_0 - \tan^{-1} ( \sqrt{x^2+y^2} - \cot \phi_0 ) + +.. math:: + + \lambda = \frac{\tan^{-1} \sqrt{x^2+y^2}}{\sin \phi_0} + +Reference values +================== + +For ATPOL to WGS84 test, run the following script: + +:: + + #!/bin/bash + cat << EOF | src/cs2cs -v -f "%E" +proj=ccon +lat_1=52 +lat_0=52 +lon_0=19 +axis=esu +a=6390000 +x_0=330000 +y_0=-350000 +to +proj=longlat +datum=WGS84 +no_defs + 0 0 + 0 700000 + 700000 0 + 700000 700000 + 330000 350000 + EOF + +It should result with + +:: + + 1.384023E+01 5.503040E+01 0.000000E+00 + 1.451445E+01 4.877385E+01 0.000000E+00 + 2.478271E+01 5.500352E+01 0.000000E+00 + 2.402761E+01 4.875048E+01 0.000000E+00 + 1.900000E+01 5.200000E+01 0.000000E+00 + +Analogous script can be run for reverse test: + +:: + + cat << EOF | src/cs2cs -v -f "%E" +proj=longlat +datum=WGS84 +no_defs +to +proj=ccon +lat_1=52 +lat_0=52 +lon_0=19 +axis=esu +a=6390000 +x_0=330000 +y_0=-350000 + 24 55 + 15 49 + 24 49 + 19 52 + EOF + +and it should give the following results: + +:: + + 6.500315E+05 4.106162E+03 0.000000E+00 + 3.707419E+04 6.768262E+05 0.000000E+00 + 6.960534E+05 6.722946E+05 0.000000E+00 + 3.300000E+05 3.500000E+05 0.000000E+00 diff --git a/docs/source/operations/projections/cea.rst b/docs/source/operations/projections/cea.rst new file mode 100644 index 00000000..20ebc285 --- /dev/null +++ b/docs/source/operations/projections/cea.rst @@ -0,0 +1,10 @@ +.. _cea: + +******************************************************************************** +Equal Area Cylindrical +******************************************************************************** + +.. image:: ./images/cea.png + :scale: 50% + :alt: Equal Area Cylindrical + diff --git a/docs/source/operations/projections/chamb.rst b/docs/source/operations/projections/chamb.rst new file mode 100644 index 00000000..2ec9bffe --- /dev/null +++ b/docs/source/operations/projections/chamb.rst @@ -0,0 +1,10 @@ +.. _chamb: + +******************************************************************************** +Chamberlin Trimetric +******************************************************************************** + +.. image:: ./images/chamb.png + :scale: 50% + :alt: Chamberlin Trimetric + diff --git a/docs/source/operations/projections/collg.rst b/docs/source/operations/projections/collg.rst new file mode 100644 index 00000000..aa16182a --- /dev/null +++ b/docs/source/operations/projections/collg.rst @@ -0,0 +1,10 @@ +.. _collg: + +******************************************************************************** +Collignon +******************************************************************************** + +.. image:: ./images/collg.png + :scale: 50% + :alt: Collignon + diff --git a/docs/source/operations/projections/crast.rst b/docs/source/operations/projections/crast.rst new file mode 100644 index 00000000..9d17f274 --- /dev/null +++ b/docs/source/operations/projections/crast.rst @@ -0,0 +1,10 @@ +.. _crast: + +******************************************************************************** +Craster Parabolic (Putnins P4) +******************************************************************************** + +.. image:: ./images/crast.png + :scale: 50% + :alt: Craster Parabolic (Putnins P4) + diff --git a/docs/source/operations/projections/denoy.rst b/docs/source/operations/projections/denoy.rst new file mode 100644 index 00000000..a885ab0e --- /dev/null +++ b/docs/source/operations/projections/denoy.rst @@ -0,0 +1,10 @@ +.. _denoy: + +******************************************************************************** +Denoyer Semi-Elliptical +******************************************************************************** + +.. image:: ./images/denoy.png + :scale: 50% + :alt: Denoyer Semi-Elliptical + diff --git a/docs/source/operations/projections/eck1.rst b/docs/source/operations/projections/eck1.rst new file mode 100644 index 00000000..841533ec --- /dev/null +++ b/docs/source/operations/projections/eck1.rst @@ -0,0 +1,18 @@ +.. _eck1: + +******************************************************************************** +Eckert I +******************************************************************************** + +.. image:: ./images/eck1.png + :scale: 50% + :alt: Eckert I + + +.. math:: + + x &= 2 \sqrt{2/3\pi} \lambda (1- |\phi|/\pi) + + y &= 2 \sqrt{2/3\pi}\phi + + diff --git a/docs/source/operations/projections/eck2.rst b/docs/source/operations/projections/eck2.rst new file mode 100644 index 00000000..b1bd3179 --- /dev/null +++ b/docs/source/operations/projections/eck2.rst @@ -0,0 +1,10 @@ +.. _eck2: + +******************************************************************************** +Eckert II +******************************************************************************** + +.. image:: ./images/eck2.png + :scale: 50% + :alt: Eckert II + diff --git a/docs/source/operations/projections/eck3.rst b/docs/source/operations/projections/eck3.rst new file mode 100644 index 00000000..ecacc32d --- /dev/null +++ b/docs/source/operations/projections/eck3.rst @@ -0,0 +1,10 @@ +.. _eck3: + +******************************************************************************** +Eckert III +******************************************************************************** + +.. image:: ./images/eck3.png + :scale: 50% + :alt: Eckert III + diff --git a/docs/source/operations/projections/eck4.rst b/docs/source/operations/projections/eck4.rst new file mode 100644 index 00000000..3fc6a9fd --- /dev/null +++ b/docs/source/operations/projections/eck4.rst @@ -0,0 +1,19 @@ +.. _eck4: + +******************************************************************************** +Eckert IV +******************************************************************************** + +.. image:: ./images/eck4.png + :scale: 50% + :alt: Eckert IV + + +.. math:: + + x = \lambda(1+cos\phi) / \sqrt{ 2 + \pi } + +.. math:: + y = 2 \phi / \sqrt { 2 + \pi } + + diff --git a/docs/source/operations/projections/eck5.rst b/docs/source/operations/projections/eck5.rst new file mode 100644 index 00000000..1442d99d --- /dev/null +++ b/docs/source/operations/projections/eck5.rst @@ -0,0 +1,10 @@ +.. _eck5: + +******************************************************************************** +Eckert V +******************************************************************************** + +.. image:: ./images/eck5.png + :scale: 50% + :alt: Eckert V + diff --git a/docs/source/operations/projections/eck6.rst b/docs/source/operations/projections/eck6.rst new file mode 100644 index 00000000..caeaefa6 --- /dev/null +++ b/docs/source/operations/projections/eck6.rst @@ -0,0 +1,10 @@ +.. _eck6: + +******************************************************************************** +Eckert VI +******************************************************************************** + +.. image:: ./images/eck6.png + :scale: 50% + :alt: Eckert VI + diff --git a/docs/source/operations/projections/eqc.rst b/docs/source/operations/projections/eqc.rst new file mode 100644 index 00000000..be431977 --- /dev/null +++ b/docs/source/operations/projections/eqc.rst @@ -0,0 +1,110 @@ +.. _eqc: + +******************************************************************************** +Equidistant Cylindrical (Plate Carrée) +******************************************************************************** + +The simplest of all projections. Standard parallels (0° when omitted) may be specified that determine latitude of true scale (k=h=1). + ++---------------------+----------------------------------------------------------+ +| **Classification** | Conformal cylindrical | ++---------------------+----------------------------------------------------------+ +| **Available forms** | Forward and inverse | ++---------------------+----------------------------------------------------------+ +| **Defined area** | Global, but best used near the equator | ++---------------------+----------------------------------------------------------+ +| **Implemented by** | Gerald I. Evenden | ++---------------------+----------------------------------------------------------+ +| **Options** | ++---------------------+----------------------------------------------------------+ +| `+lat_ts` | Latitude of true scale. Defaults to 0.0 | ++---------------------+----------------------------------------------------------+ +| `+lat_0` | Center of the map : latitude of origin | ++---------------------+----------------------------------------------------------+ + +.. image:: ./images/eqc.png + :scale: 50% + :alt: Equidistant Cylindrical (Plate Carrée) + +Usage +######## + +Because of the distortions introduced by this projection, it has little use in navigation or cadastral mapping and finds its main use in thematic mapping. +In particular, the plate carrée has become a standard for global raster datasets, such as Celestia and NASA World Wind, because of the particularly simple relationship between the position of an image pixel on the map and its corresponding geographic location on Earth. + +The following table gives special cases of the cylindrical equidistant projection. + ++---------------------------------------------------------+--------------------------+ +| Projection Name | (lat ts=) :math:`\phi_0` | ++---------------------------------------------------------+--------------------------+ +| Plain/Plane Chart | 0° | ++---------------------------------------------------------+--------------------------+ +| Simple Cylindrical | 0° | ++---------------------------------------------------------+--------------------------+ +| Plate Carrée | 0° | ++---------------------------------------------------------+--------------------------+ +| Ronald Miller—minimum overall scale distortion | 37°30′ | ++---------------------------------------------------------+--------------------------+ +| E.Grafarend and A.Niermann | 42° | ++---------------------------------------------------------+--------------------------+ +| Ronald Miller—minimum continental scale distortion | 43°30′ | ++---------------------------------------------------------+--------------------------+ +| Gall Isographic | 45° | ++---------------------------------------------------------+--------------------------+ +| Ronald Miller Equirectangular | 50°30′ | ++---------------------------------------------------------+--------------------------+ +| E.Grafarend and A.Niermann minimum linear distortion | 61°7′ | ++---------------------------------------------------------+--------------------------+ + + +Example using EPSG 32662 (WGS84 Plate Carrée):: + + $ echo 2 47 | proj +proj=eqc +lat_ts=0 +lat_0=0 +lon_0=0 +x_0=0 +y_0=0 +ellps=WGS84 +datum=WGS84 +units=m +no_defs + 222638.98 5232016.07 + +Example using Plate Carrée projection with true scale at latitude 30° and central meridian 90°W:: + + $ echo -88 30 | proj +proj=eqc +lat_ts=30 +lat_0=90w + -8483684.61 13358338.90 + + +Mathematical definition +####################### + +The formulas describing the Equidistant Cylindrical projection are all taken from Snyder's [Snyder1987]_. + +:math:`\phi_{ts}` is the latitude of true scale, that mean the standard parallels where the scale of the projection is true. It can be set with ``+lat_ts``. + +:math:`\phi_0` is the latitude of origin that match the center of the map. It can be set with ``+lat_0``. + + +Forward projection +================== + +.. math:: + + x = \lambda \cos \phi_{ts} + +.. math:: + + y = \phi - \phi_0 + +Inverse projection +================== + +.. math:: + + \lambda = x / cos \phi_{ts} + +.. math:: + + \phi = y + \phi_0 + + +Further reading +############### + +#. `Wikipedia `_ +#. `Wolfram Mathworld `_ + + diff --git a/docs/source/operations/projections/eqdc.rst b/docs/source/operations/projections/eqdc.rst new file mode 100644 index 00000000..3ee5999d --- /dev/null +++ b/docs/source/operations/projections/eqdc.rst @@ -0,0 +1,10 @@ +.. _eqdc: + +******************************************************************************** +Equidistant Conic +******************************************************************************** + +.. image:: ./images/eqdc.png + :scale: 50% + :alt: Equidistant Conic + diff --git a/docs/source/operations/projections/etmerc.rst b/docs/source/operations/projections/etmerc.rst new file mode 100644 index 00000000..b7f89032 --- /dev/null +++ b/docs/source/operations/projections/etmerc.rst @@ -0,0 +1,10 @@ +.. _etmerc: + +******************************************************************************** +Extended Transverse Mercator +******************************************************************************** + +.. image:: ./images/etmerc.png + :scale: 50% + :alt: Extended Transverse Mercator + diff --git a/docs/source/operations/projections/euler.rst b/docs/source/operations/projections/euler.rst new file mode 100644 index 00000000..e495063f --- /dev/null +++ b/docs/source/operations/projections/euler.rst @@ -0,0 +1,10 @@ +.. _euler: + +******************************************************************************** +Euler +******************************************************************************** + +.. image:: ./images/euler.png + :scale: 50% + :alt: Euler + diff --git a/docs/source/operations/projections/fahey.rst b/docs/source/operations/projections/fahey.rst new file mode 100644 index 00000000..2e09337f --- /dev/null +++ b/docs/source/operations/projections/fahey.rst @@ -0,0 +1,10 @@ +.. _fahey: + +******************************************************************************** +Fahey +******************************************************************************** + +.. image:: ./images/fahey.png + :scale: 50% + :alt: Fahey + diff --git a/docs/source/operations/projections/fouc.rst b/docs/source/operations/projections/fouc.rst new file mode 100644 index 00000000..7467dcb1 --- /dev/null +++ b/docs/source/operations/projections/fouc.rst @@ -0,0 +1,10 @@ +.. _fouc: + +******************************************************************************** +Foucaut +******************************************************************************** + +.. image:: ./images/fouc.png + :scale: 50% + :alt: Foucaut + diff --git a/docs/source/operations/projections/fouc_s.rst b/docs/source/operations/projections/fouc_s.rst new file mode 100644 index 00000000..ac353adb --- /dev/null +++ b/docs/source/operations/projections/fouc_s.rst @@ -0,0 +1,25 @@ +.. _fouc_s: + +******************************************************************************** +Foucaut Sinusoidal +******************************************************************************** + +.. image:: ./images/fouc_s.png + :scale: 50% + :alt: Foucaut Sinusoidal + + +The `y`-axis is based upon a weighted mean of the cylindrical equal-area and +the sinusoidal projections. Parameter :math:`n=n` is the weighting factor where +:math:`0 <= n <= 1`. + +.. math:: + + x &= \lambda \cos \phi / (n + (1 - n) \ cos \phi) + + y &= n \phi + (1 - n) \sin \phi + +For the inverse, the Newton-Raphson method can be used to determine +:math:`\phi` from the equation for :math:`y` above. As :math:`n \rightarrow 0` and +:math:`\phi \rightarrow \pi/2`, convergence is slow but for :math:`n = 0`, :math:`\phi = +\sin^1y` diff --git a/docs/source/operations/projections/gall.rst b/docs/source/operations/projections/gall.rst new file mode 100644 index 00000000..b9120d9f --- /dev/null +++ b/docs/source/operations/projections/gall.rst @@ -0,0 +1,84 @@ +.. _gall: + +******************************************************************************** +Gall (Gall Stereographic) +******************************************************************************** + +The Gall stereographic projection, presented by James Gall in 1855, is a cylindrical projection. +It is neither equal-area nor conformal but instead tries to balance the distortion inherent in any projection. + ++---------------------+--------------------------------------------------------------------------------+ +| **Classification** | Transverse and oblique cylindrical | ++---------------------+--------------------------------------------------------------------------------+ +| **Available forms** | Forward and inverse, Spherical | ++---------------------+--------------------------------------------------------------------------------+ +| **Defined area** | Global | ++---------------------+--------------------------------------------------------------------------------+ +| **Implemented by** | Gerald I. Evenden | ++---------------------+--------------------------------------------------------------------------------+ +| **Options** | No special options for this projection | ++---------------------+--------------------------------------------------------------------------------+ + + +.. image:: ./images/gall.png + :scale: 50% + :alt: Gall (Gall Stereographic) + +Usage +##### + +The need for a world map which avoids some of the scale exaggeration of the Mercator projection has led to some commonly used cylindrical modifications, as well as to other modifications which are not cylindrical. +The earliest common cylindrical example was developed by James Gall of Edinburgh about 1855 (Gall, 1885, p. 119-123). +His meridians are equally spaced, but the parallels are spaced at increasing intervals away from the Equator. +The parallels of latitude are actually projected onto a cylinder wrapped about the sphere, but cutting it at lats. 45° N. and S., the point of perspective being a point on the Equator opposite the meridian being projected. +It is used in several British atlases, but seldom in the United States. +The Gall projection is neither conformal nor equal-area, but has a blend of various features. +Unlike the Mercator, the Gall shows the poles as lines running across the top and bottom of the map. + + +Example using Gall Stereographical :: + + $ echo 9 51 | proj +proj=gall +lon_0=0 +x_0=0 +y_0=0 +ellps=WGS84 +datum=WGS84 +units=m +no_defs + 708432.90 5193386.36 + +Example using Gall Stereographical (Central meridian 90°W) :: + + $ echo 9 51 | proj +proj=gall +lon_0=90w +x_0=0 +y_0=0 +ellps=WGS84 +datum=WGS84 +units=m +no_defs + 7792761.91 5193386.36 + +Mathematical definition +####################### + +The formulas describing the Gall Stereographical are all taken from Snyder's [Snyder1993]_. + +Spherical form +************** + +Forward projection +================== + +.. math:: + + x = \frac{\lambda}{\sqrt{2}} + +.. math:: + + y = (1+\frac{\sqrt{2}}{2}) \tan(\phi/2) + +Inverse projection +================== + +.. math:: + + \phi = 2 \arctan( \frac{y}{1+\frac{\sqrt{2}}{2}} ) + +.. math:: + + \lambda = \sqrt{2} x + + +Further reading +############### + +#. `Wikipedia `_ +#. `Cartographic Projection Procedures for the UNIX Environment-A User's Manual `_ diff --git a/docs/source/operations/projections/geos.rst b/docs/source/operations/projections/geos.rst new file mode 100644 index 00000000..cd576283 --- /dev/null +++ b/docs/source/operations/projections/geos.rst @@ -0,0 +1,72 @@ +.. _geos: + +******************************************************************************** +Geostationary Satellite View +******************************************************************************** ++---------------------+----------------------------------------------------------+ +| **Classification** | Azimuthal | ++---------------------+----------------------------------------------------------+ +| **Available forms** | Forward and inverse, spherical and elliptical projection | ++---------------------+----------------------------------------------------------+ +| **Defined area** | Global | ++---------------------+----------------------------------------------------------+ +| **Implemented by** | Gerald I. Evenden and Martin Raspaud | ++---------------------+----------------------------------------------------------+ +| **Options** | ++---------------------+----------------------------------------------------------+ +| `+h` | Satellite height above earth. Required. | ++---------------------+----------------------------------------------------------+ +| `+sweep` | Sweep angle axis of the viewing instrument. | +| | Valid options are ``x`` and ``y``. Defaults to ``y``. | ++---------------------+----------------------------------------------------------+ +| `+lon_0` | Subsatellite longitude point. | ++---------------------+----------------------------------------------------------+ + + +.. image:: ./images/geos.png + :scale: 50% + :alt: Geostationary Satellite View + +The geos projection pictures how a geostationary satellite scans the earth at regular +scanning angle intervals. + + +Usage +############################################################################### + +In order to project using the geos projection you can do the following:: + + proj +proj=geos +h=35785831.0 + +The required argument ``h`` is the viewing point (satellite position) height above +the earth. + +The projection coordinate relate to the scanning angle by the following simple +relation:: + + scanning_angle (radians) = projection_coordinate / h + + +Note on sweep angle +------------------------------------------------------------------------------- + +The viewing instrument on-board geostationary satellites described by this +projection have a two-axis gimbal viewing geometry. This means that the different +scanning positions are obtained by rotating the gimbal along a N/S axis (or ``y``) +and a E/W axis (or ``x``). + +.. image:: ../../..//images/geos_sweep.png + :scale: 50% + :alt: Gimbal geometry + +In the image above, the outer-gimbal axis, or sweep-angle axis, is the N/S axis (``y``) +while the inner-gimbal axis, or fixed-angle axis, is the E/W axis (``x``). + +This example represents the scanning geometry of the Meteosat series satellite. +However, the GOES satellite series use the opposite scanning geometry, with the +E/W axis (``x``) as the sweep-angle axis, and the N/S (``y``) as the fixed-angle axis. + +The sweep argument is used to tell PROJ which on which axis the outer-gimbal +is rotating. The possible values are x or y, y being the default. Thus, the +scanning geometry of the Meteosat series satellite should take sweep as x, and +GOES should take sweep as y. diff --git a/docs/source/operations/projections/gins8.rst b/docs/source/operations/projections/gins8.rst new file mode 100644 index 00000000..f6adb092 --- /dev/null +++ b/docs/source/operations/projections/gins8.rst @@ -0,0 +1,10 @@ +.. _gins8: + +******************************************************************************** +Ginsburg VIII (TsNIIGAiK) +******************************************************************************** + +.. image:: ./images/gins8.png + :scale: 50% + :alt: Ginsburg VIII (TsNIIGAiK) + diff --git a/docs/source/operations/projections/gn_sinu.rst b/docs/source/operations/projections/gn_sinu.rst new file mode 100644 index 00000000..c1017c27 --- /dev/null +++ b/docs/source/operations/projections/gn_sinu.rst @@ -0,0 +1,10 @@ +.. _gn_sinu: + +******************************************************************************** +General Sinusoidal Series +******************************************************************************** + +.. image:: ./images/gn_sinu.png + :scale: 50% + :alt: General Sinusoidal Series + diff --git a/docs/source/operations/projections/gnom.rst b/docs/source/operations/projections/gnom.rst new file mode 100644 index 00000000..08d0db5f --- /dev/null +++ b/docs/source/operations/projections/gnom.rst @@ -0,0 +1,10 @@ +.. _gnom: + +******************************************************************************** +Gnomonic +******************************************************************************** + +.. image:: ./images/gnom.png + :scale: 50% + :alt: Gnomonic + diff --git a/docs/source/operations/projections/goode.rst b/docs/source/operations/projections/goode.rst new file mode 100644 index 00000000..c4590bf2 --- /dev/null +++ b/docs/source/operations/projections/goode.rst @@ -0,0 +1,10 @@ +.. _goode: + +******************************************************************************** +Goode Homolosine +******************************************************************************** + +.. image:: ./images/goode.png + :scale: 50% + :alt: Goode Homolosine + diff --git a/docs/source/operations/projections/gs48.rst b/docs/source/operations/projections/gs48.rst new file mode 100644 index 00000000..bdaa367c --- /dev/null +++ b/docs/source/operations/projections/gs48.rst @@ -0,0 +1,10 @@ +.. _gs48: + +******************************************************************************** +Mod. Stererographics of 48 U.S. +******************************************************************************** + +.. image:: ./images/gs48.png + :scale: 50% + :alt: Mod. Stererographics of 48 U.S. + diff --git a/docs/source/operations/projections/gs50.rst b/docs/source/operations/projections/gs50.rst new file mode 100644 index 00000000..0d4b7e81 --- /dev/null +++ b/docs/source/operations/projections/gs50.rst @@ -0,0 +1,10 @@ +.. _gs50: + +******************************************************************************** +Mod. Stererographics of 50 U.S. +******************************************************************************** + +.. image:: ./images/gs50.png + :scale: 50% + :alt: Mod. Stererographics of 50 U.S. + diff --git a/docs/source/operations/projections/gstmerc.rst b/docs/source/operations/projections/gstmerc.rst new file mode 100644 index 00000000..fc587ab0 --- /dev/null +++ b/docs/source/operations/projections/gstmerc.rst @@ -0,0 +1,10 @@ +.. _gstmerc: + +******************************************************************************** +Gauss-Schreiber Transverse Mercator (aka Gauss-Laborde Reunion) +******************************************************************************** + +.. image:: ./images/gstmerc.png + :scale: 50% + :alt: Gauss-Schreiber Transverse Mercator (aka Gauss-Laborde Reunion) + diff --git a/docs/source/operations/projections/hammer.rst b/docs/source/operations/projections/hammer.rst new file mode 100644 index 00000000..e795b91b --- /dev/null +++ b/docs/source/operations/projections/hammer.rst @@ -0,0 +1,10 @@ +.. _hammer: + +******************************************************************************** +Hammer & Eckert-Greifendorff +******************************************************************************** + +.. image:: ./images/hammer.png + :scale: 50% + :alt: Hammer & Eckert-Greifendorff + diff --git a/docs/source/operations/projections/hatano.rst b/docs/source/operations/projections/hatano.rst new file mode 100644 index 00000000..5d0c63b7 --- /dev/null +++ b/docs/source/operations/projections/hatano.rst @@ -0,0 +1,70 @@ +.. _hatano: + +******************************************************************************** +Hatano Asymmetrical Equal Area +******************************************************************************** + + + + ++---------------------+----------------------------------------------------------+ +| **Classification** | :term:`Pseudocylindrical Projection` | ++---------------------+----------------------------------------------------------+ +| **Available forms** | Forward and inverse, spherical projection | ++---------------------+----------------------------------------------------------+ +| **Defined area** | Global, but best between standard parallels | ++---------------------+----------------------------------------------------------+ +| **Implemented by** | Gerald I. Evenden | ++---------------------+----------------------------------------------------------+ +| **Options** | ++---------------------+----------------------------------------------------------+ +| `+lat_1` | Standard Parallel 1 | ++---------------------+----------------------------------------------------------+ +| `+lat_2` | Standard Parallel 2 | ++---------------------+----------------------------------------------------------+ +| `+sym` | Symmetric form used instead of asymmetric | ++---------------------+----------------------------------------------------------+ + + +.. image:: ./images/hatano.png + :scale: 50% + :alt: Hatano Asymmetrical Equal Area + + + +Mathematical Definition +-------------------------------------------------------------------------------- + +Forward +................................................................................ + +.. math:: + + x &= 0.85\lambda \cos \theta + + y &= C_y \sin \theta + + P(\theta) &= 2\theta + \sin 2\theta - C_p \sin \phi + + P'(\theta) &= 2(1 + \cos 2\theta) + + \theta_0 &= 2\phi + + +==================================== ================== =================== +Condition :math:`C_p` :math:`C_p` +==================================== ================== =================== +if ``+sym`` or :math:`\phi > 0` 1.75859 2.67595 +if not ``+sym`` and :math:`\phi < 0` 1.93052 2.43763 +==================================== ================== =================== + +For :math:`\phi = 0`, :math:`y \leftarrow 0`, and :math:`x \leftarrow 0.85\lambda`. + +Further reading +-------------------------------------------------------------------------------- + +#. `Compare Map Projections `__ +#. `Mathworks `__ + + + diff --git a/docs/source/operations/projections/healpix.rst b/docs/source/operations/projections/healpix.rst new file mode 100644 index 00000000..d05b2123 --- /dev/null +++ b/docs/source/operations/projections/healpix.rst @@ -0,0 +1,55 @@ +.. _healpix: + +******************************************************************************** +HEALPix +******************************************************************************** ++---------------------+----------------------------------------------------------+ +| **Classification** | Mixed | ++---------------------+----------------------------------------------------------+ +| **Available forms** | Forward and inverse, spherical and elliptical projection | ++---------------------+----------------------------------------------------------+ +| **Defined area** | Global | ++---------------------+----------------------------------------------------------+ +| **Implemented by** | Alex Raichev and Michael Speth | ++---------------------+----------------------------------------------------------+ +| **Options** | ++---------------------+----------------------------------------------------------+ +| `No special options for this projection` | ++---------------------+----------------------------------------------------------+ + +.. image:: ../../../images/healpix.png + :scale: 75% + :alt: HEALPix + +The HEALPix projection is area preserving and can be used with a spherical and +ellipsoidal model. It was initially developed for mapping cosmic background +microwave radiation. The image below is the graphical representation of the +mapping and consists of eight isomorphic triangular interrupted map graticules. +The north and south contains four in which straight meridians converge polewards +to a point and unequally spaced horizontal parallels. HEALPix provides a mapping +in which points of equal latitude and equally spaced longitude are mapped to points +of equal latitude and equally spaced longitude with the module of the polar +interruptions. + + +Usage +############################################################################### + +To run a forward HEALPix projection on a unit sphere model, use the following command:: + + proj +proj=healpix +lon_0=0 +a=1 -E <`_ +#. `Wikipedia `_ + + + + + diff --git a/docs/source/operations/projections/igh.rst b/docs/source/operations/projections/igh.rst new file mode 100644 index 00000000..d74e1362 --- /dev/null +++ b/docs/source/operations/projections/igh.rst @@ -0,0 +1,10 @@ +.. _igh: + +******************************************************************************** +Interrupted Goode Homolosine +******************************************************************************** + +.. image:: ./images/igh.png + :scale: 50% + :alt: Interrupted Goode Homolosine + diff --git a/docs/source/operations/projections/images/aea.png b/docs/source/operations/projections/images/aea.png new file mode 100644 index 00000000..7fdd4ece Binary files /dev/null and b/docs/source/operations/projections/images/aea.png differ diff --git a/docs/source/operations/projections/images/aeqd.png b/docs/source/operations/projections/images/aeqd.png new file mode 100644 index 00000000..8e45b2c0 Binary files /dev/null and b/docs/source/operations/projections/images/aeqd.png differ diff --git a/docs/source/operations/projections/images/airy.png b/docs/source/operations/projections/images/airy.png new file mode 100644 index 00000000..a441e317 Binary files /dev/null and b/docs/source/operations/projections/images/airy.png differ diff --git a/docs/source/operations/projections/images/aitoff.png b/docs/source/operations/projections/images/aitoff.png new file mode 100644 index 00000000..3449dcd5 Binary files /dev/null and b/docs/source/operations/projections/images/aitoff.png differ diff --git a/docs/source/operations/projections/images/alsk.png b/docs/source/operations/projections/images/alsk.png new file mode 100644 index 00000000..6f6e2014 Binary files /dev/null and b/docs/source/operations/projections/images/alsk.png differ diff --git a/docs/source/operations/projections/images/apian.png b/docs/source/operations/projections/images/apian.png new file mode 100644 index 00000000..95857ae3 Binary files /dev/null and b/docs/source/operations/projections/images/apian.png differ diff --git a/docs/source/operations/projections/images/august.png b/docs/source/operations/projections/images/august.png new file mode 100644 index 00000000..9d9fece6 Binary files /dev/null and b/docs/source/operations/projections/images/august.png differ diff --git a/docs/source/operations/projections/images/bacon.png b/docs/source/operations/projections/images/bacon.png new file mode 100644 index 00000000..62deae63 Binary files /dev/null and b/docs/source/operations/projections/images/bacon.png differ diff --git a/docs/source/operations/projections/images/bipc.png b/docs/source/operations/projections/images/bipc.png new file mode 100644 index 00000000..7b8ab39c Binary files /dev/null and b/docs/source/operations/projections/images/bipc.png differ diff --git a/docs/source/operations/projections/images/boggs.png b/docs/source/operations/projections/images/boggs.png new file mode 100644 index 00000000..42dd4c13 Binary files /dev/null and b/docs/source/operations/projections/images/boggs.png differ diff --git a/docs/source/operations/projections/images/bonne.png b/docs/source/operations/projections/images/bonne.png new file mode 100644 index 00000000..12f93217 Binary files /dev/null and b/docs/source/operations/projections/images/bonne.png differ diff --git a/docs/source/operations/projections/images/calcofi.png b/docs/source/operations/projections/images/calcofi.png new file mode 100644 index 00000000..2fd405ac Binary files /dev/null and b/docs/source/operations/projections/images/calcofi.png differ diff --git a/docs/source/operations/projections/images/cass.png b/docs/source/operations/projections/images/cass.png new file mode 100644 index 00000000..e44c46af Binary files /dev/null and b/docs/source/operations/projections/images/cass.png differ diff --git a/docs/source/operations/projections/images/cc.png b/docs/source/operations/projections/images/cc.png new file mode 100644 index 00000000..3beaedfd Binary files /dev/null and b/docs/source/operations/projections/images/cc.png differ diff --git a/docs/source/operations/projections/images/ccon.png b/docs/source/operations/projections/images/ccon.png new file mode 100644 index 00000000..ccc0ec9e Binary files /dev/null and b/docs/source/operations/projections/images/ccon.png differ diff --git a/docs/source/operations/projections/images/cea.png b/docs/source/operations/projections/images/cea.png new file mode 100644 index 00000000..eca2319d Binary files /dev/null and b/docs/source/operations/projections/images/cea.png differ diff --git a/docs/source/operations/projections/images/chamb.png b/docs/source/operations/projections/images/chamb.png new file mode 100644 index 00000000..a87e6c68 Binary files /dev/null and b/docs/source/operations/projections/images/chamb.png differ diff --git a/docs/source/operations/projections/images/collg.png b/docs/source/operations/projections/images/collg.png new file mode 100644 index 00000000..851201da Binary files /dev/null and b/docs/source/operations/projections/images/collg.png differ diff --git a/docs/source/operations/projections/images/comill.png b/docs/source/operations/projections/images/comill.png new file mode 100644 index 00000000..725a0118 Binary files /dev/null and b/docs/source/operations/projections/images/comill.png differ diff --git a/docs/source/operations/projections/images/crast.png b/docs/source/operations/projections/images/crast.png new file mode 100644 index 00000000..abd4d32a Binary files /dev/null and b/docs/source/operations/projections/images/crast.png differ diff --git a/docs/source/operations/projections/images/denoy.png b/docs/source/operations/projections/images/denoy.png new file mode 100644 index 00000000..2871cf84 Binary files /dev/null and b/docs/source/operations/projections/images/denoy.png differ diff --git a/docs/source/operations/projections/images/eck1.png b/docs/source/operations/projections/images/eck1.png new file mode 100644 index 00000000..b892d39e Binary files /dev/null and b/docs/source/operations/projections/images/eck1.png differ diff --git a/docs/source/operations/projections/images/eck2.png b/docs/source/operations/projections/images/eck2.png new file mode 100644 index 00000000..ff011598 Binary files /dev/null and b/docs/source/operations/projections/images/eck2.png differ diff --git a/docs/source/operations/projections/images/eck3.png b/docs/source/operations/projections/images/eck3.png new file mode 100644 index 00000000..f828eed0 Binary files /dev/null and b/docs/source/operations/projections/images/eck3.png differ diff --git a/docs/source/operations/projections/images/eck4.png b/docs/source/operations/projections/images/eck4.png new file mode 100644 index 00000000..d7ff87bb Binary files /dev/null and b/docs/source/operations/projections/images/eck4.png differ diff --git a/docs/source/operations/projections/images/eck5.png b/docs/source/operations/projections/images/eck5.png new file mode 100644 index 00000000..3df303c6 Binary files /dev/null and b/docs/source/operations/projections/images/eck5.png differ diff --git a/docs/source/operations/projections/images/eck6.png b/docs/source/operations/projections/images/eck6.png new file mode 100644 index 00000000..d22f4956 Binary files /dev/null and b/docs/source/operations/projections/images/eck6.png differ diff --git a/docs/source/operations/projections/images/eqc.png b/docs/source/operations/projections/images/eqc.png new file mode 100644 index 00000000..b2d8ba23 Binary files /dev/null and b/docs/source/operations/projections/images/eqc.png differ diff --git a/docs/source/operations/projections/images/eqdc.png b/docs/source/operations/projections/images/eqdc.png new file mode 100644 index 00000000..f2330a8e Binary files /dev/null and b/docs/source/operations/projections/images/eqdc.png differ diff --git a/docs/source/operations/projections/images/etmerc.png b/docs/source/operations/projections/images/etmerc.png new file mode 100644 index 00000000..8e6bb39b Binary files /dev/null and b/docs/source/operations/projections/images/etmerc.png differ diff --git a/docs/source/operations/projections/images/euler.png b/docs/source/operations/projections/images/euler.png new file mode 100644 index 00000000..c9c6e4c8 Binary files /dev/null and b/docs/source/operations/projections/images/euler.png differ diff --git a/docs/source/operations/projections/images/fahey.png b/docs/source/operations/projections/images/fahey.png new file mode 100644 index 00000000..8b870b8a Binary files /dev/null and b/docs/source/operations/projections/images/fahey.png differ diff --git a/docs/source/operations/projections/images/fouc.png b/docs/source/operations/projections/images/fouc.png new file mode 100644 index 00000000..6d33216b Binary files /dev/null and b/docs/source/operations/projections/images/fouc.png differ diff --git a/docs/source/operations/projections/images/fouc_s.png b/docs/source/operations/projections/images/fouc_s.png new file mode 100644 index 00000000..401f5ee4 Binary files /dev/null and b/docs/source/operations/projections/images/fouc_s.png differ diff --git a/docs/source/operations/projections/images/gall.png b/docs/source/operations/projections/images/gall.png new file mode 100644 index 00000000..819b5d12 Binary files /dev/null and b/docs/source/operations/projections/images/gall.png differ diff --git a/docs/source/operations/projections/images/geos.png b/docs/source/operations/projections/images/geos.png new file mode 100644 index 00000000..e44fa41b Binary files /dev/null and b/docs/source/operations/projections/images/geos.png differ diff --git a/docs/source/operations/projections/images/gins8.png b/docs/source/operations/projections/images/gins8.png new file mode 100644 index 00000000..12fbae93 Binary files /dev/null and b/docs/source/operations/projections/images/gins8.png differ diff --git a/docs/source/operations/projections/images/gn_sinu.png b/docs/source/operations/projections/images/gn_sinu.png new file mode 100644 index 00000000..f02e119e Binary files /dev/null and b/docs/source/operations/projections/images/gn_sinu.png differ diff --git a/docs/source/operations/projections/images/gnom.png b/docs/source/operations/projections/images/gnom.png new file mode 100644 index 00000000..c079d31a Binary files /dev/null and b/docs/source/operations/projections/images/gnom.png differ diff --git a/docs/source/operations/projections/images/goode.png b/docs/source/operations/projections/images/goode.png new file mode 100644 index 00000000..7001e8d2 Binary files /dev/null and b/docs/source/operations/projections/images/goode.png differ diff --git a/docs/source/operations/projections/images/gs48.png b/docs/source/operations/projections/images/gs48.png new file mode 100644 index 00000000..574e368f Binary files /dev/null and b/docs/source/operations/projections/images/gs48.png differ diff --git a/docs/source/operations/projections/images/gs50.png b/docs/source/operations/projections/images/gs50.png new file mode 100644 index 00000000..7244b160 Binary files /dev/null and b/docs/source/operations/projections/images/gs50.png differ diff --git a/docs/source/operations/projections/images/gstmerc.png b/docs/source/operations/projections/images/gstmerc.png new file mode 100644 index 00000000..d553ea60 Binary files /dev/null and b/docs/source/operations/projections/images/gstmerc.png differ diff --git a/docs/source/operations/projections/images/hammer.png b/docs/source/operations/projections/images/hammer.png new file mode 100644 index 00000000..83848479 Binary files /dev/null and b/docs/source/operations/projections/images/hammer.png differ diff --git a/docs/source/operations/projections/images/hatano.png b/docs/source/operations/projections/images/hatano.png new file mode 100644 index 00000000..b3f47377 Binary files /dev/null and b/docs/source/operations/projections/images/hatano.png differ diff --git a/docs/source/operations/projections/images/healpix.png b/docs/source/operations/projections/images/healpix.png new file mode 100644 index 00000000..c58a155c Binary files /dev/null and b/docs/source/operations/projections/images/healpix.png differ diff --git a/docs/source/operations/projections/images/igh.png b/docs/source/operations/projections/images/igh.png new file mode 100644 index 00000000..36336eec Binary files /dev/null and b/docs/source/operations/projections/images/igh.png differ diff --git a/docs/source/operations/projections/images/imw_p.png b/docs/source/operations/projections/images/imw_p.png new file mode 100644 index 00000000..74cfe81b Binary files /dev/null and b/docs/source/operations/projections/images/imw_p.png differ diff --git a/docs/source/operations/projections/images/isea.png b/docs/source/operations/projections/images/isea.png new file mode 100644 index 00000000..23cfbf74 Binary files /dev/null and b/docs/source/operations/projections/images/isea.png differ diff --git a/docs/source/operations/projections/images/kav5.png b/docs/source/operations/projections/images/kav5.png new file mode 100644 index 00000000..d5c45400 Binary files /dev/null and b/docs/source/operations/projections/images/kav5.png differ diff --git a/docs/source/operations/projections/images/kav7.png b/docs/source/operations/projections/images/kav7.png new file mode 100644 index 00000000..50d7e6e6 Binary files /dev/null and b/docs/source/operations/projections/images/kav7.png differ diff --git a/docs/source/operations/projections/images/krovak.png b/docs/source/operations/projections/images/krovak.png new file mode 100644 index 00000000..d0d69547 Binary files /dev/null and b/docs/source/operations/projections/images/krovak.png differ diff --git a/docs/source/operations/projections/images/labrd.png b/docs/source/operations/projections/images/labrd.png new file mode 100644 index 00000000..e4a174c0 Binary files /dev/null and b/docs/source/operations/projections/images/labrd.png differ diff --git a/docs/source/operations/projections/images/laea.png b/docs/source/operations/projections/images/laea.png new file mode 100644 index 00000000..f52c7c1f Binary files /dev/null and b/docs/source/operations/projections/images/laea.png differ diff --git a/docs/source/operations/projections/images/lagrng.png b/docs/source/operations/projections/images/lagrng.png new file mode 100644 index 00000000..e48210bb Binary files /dev/null and b/docs/source/operations/projections/images/lagrng.png differ diff --git a/docs/source/operations/projections/images/larr.png b/docs/source/operations/projections/images/larr.png new file mode 100644 index 00000000..967b91d2 Binary files /dev/null and b/docs/source/operations/projections/images/larr.png differ diff --git a/docs/source/operations/projections/images/lask.png b/docs/source/operations/projections/images/lask.png new file mode 100644 index 00000000..dff0e8fa Binary files /dev/null and b/docs/source/operations/projections/images/lask.png differ diff --git a/docs/source/operations/projections/images/lcc.png b/docs/source/operations/projections/images/lcc.png new file mode 100644 index 00000000..4714b74e Binary files /dev/null and b/docs/source/operations/projections/images/lcc.png differ diff --git a/docs/source/operations/projections/images/lcca.png b/docs/source/operations/projections/images/lcca.png new file mode 100644 index 00000000..0c404670 Binary files /dev/null and b/docs/source/operations/projections/images/lcca.png differ diff --git a/docs/source/operations/projections/images/leac.png b/docs/source/operations/projections/images/leac.png new file mode 100644 index 00000000..1f57d192 Binary files /dev/null and b/docs/source/operations/projections/images/leac.png differ diff --git a/docs/source/operations/projections/images/lee_os.png b/docs/source/operations/projections/images/lee_os.png new file mode 100644 index 00000000..3e258393 Binary files /dev/null and b/docs/source/operations/projections/images/lee_os.png differ diff --git a/docs/source/operations/projections/images/loxim.png b/docs/source/operations/projections/images/loxim.png new file mode 100644 index 00000000..a03ba94e Binary files /dev/null and b/docs/source/operations/projections/images/loxim.png differ diff --git a/docs/source/operations/projections/images/lsat.png b/docs/source/operations/projections/images/lsat.png new file mode 100644 index 00000000..ec608544 Binary files /dev/null and b/docs/source/operations/projections/images/lsat.png differ diff --git a/docs/source/operations/projections/images/mbt_fps.png b/docs/source/operations/projections/images/mbt_fps.png new file mode 100644 index 00000000..e97cd21e Binary files /dev/null and b/docs/source/operations/projections/images/mbt_fps.png differ diff --git a/docs/source/operations/projections/images/mbt_s.png b/docs/source/operations/projections/images/mbt_s.png new file mode 100644 index 00000000..4432e83b Binary files /dev/null and b/docs/source/operations/projections/images/mbt_s.png differ diff --git a/docs/source/operations/projections/images/mbtfpp.png b/docs/source/operations/projections/images/mbtfpp.png new file mode 100644 index 00000000..3d0c4fb5 Binary files /dev/null and b/docs/source/operations/projections/images/mbtfpp.png differ diff --git a/docs/source/operations/projections/images/mbtfpq.png b/docs/source/operations/projections/images/mbtfpq.png new file mode 100644 index 00000000..b31c52ce Binary files /dev/null and b/docs/source/operations/projections/images/mbtfpq.png differ diff --git a/docs/source/operations/projections/images/mbtfps.png b/docs/source/operations/projections/images/mbtfps.png new file mode 100644 index 00000000..83891be6 Binary files /dev/null and b/docs/source/operations/projections/images/mbtfps.png differ diff --git a/docs/source/operations/projections/images/merc.png b/docs/source/operations/projections/images/merc.png new file mode 100644 index 00000000..8202789e Binary files /dev/null and b/docs/source/operations/projections/images/merc.png differ diff --git a/docs/source/operations/projections/images/mil_os.png b/docs/source/operations/projections/images/mil_os.png new file mode 100644 index 00000000..3316d317 Binary files /dev/null and b/docs/source/operations/projections/images/mil_os.png differ diff --git a/docs/source/operations/projections/images/mill.png b/docs/source/operations/projections/images/mill.png new file mode 100644 index 00000000..f62e517c Binary files /dev/null and b/docs/source/operations/projections/images/mill.png differ diff --git a/docs/source/operations/projections/images/misrsom.png b/docs/source/operations/projections/images/misrsom.png new file mode 100644 index 00000000..493baff3 Binary files /dev/null and b/docs/source/operations/projections/images/misrsom.png differ diff --git a/docs/source/operations/projections/images/moll.png b/docs/source/operations/projections/images/moll.png new file mode 100644 index 00000000..5d599579 Binary files /dev/null and b/docs/source/operations/projections/images/moll.png differ diff --git a/docs/source/operations/projections/images/murd1.png b/docs/source/operations/projections/images/murd1.png new file mode 100644 index 00000000..34d628c5 Binary files /dev/null and b/docs/source/operations/projections/images/murd1.png differ diff --git a/docs/source/operations/projections/images/murd2.png b/docs/source/operations/projections/images/murd2.png new file mode 100644 index 00000000..b3fdabdd Binary files /dev/null and b/docs/source/operations/projections/images/murd2.png differ diff --git a/docs/source/operations/projections/images/murd3.png b/docs/source/operations/projections/images/murd3.png new file mode 100644 index 00000000..354b009c Binary files /dev/null and b/docs/source/operations/projections/images/murd3.png differ diff --git a/docs/source/operations/projections/images/natearth.png b/docs/source/operations/projections/images/natearth.png new file mode 100644 index 00000000..0e182a0b Binary files /dev/null and b/docs/source/operations/projections/images/natearth.png differ diff --git a/docs/source/operations/projections/images/natearth2.png b/docs/source/operations/projections/images/natearth2.png new file mode 100644 index 00000000..3757646c Binary files /dev/null and b/docs/source/operations/projections/images/natearth2.png differ diff --git a/docs/source/operations/projections/images/nell.png b/docs/source/operations/projections/images/nell.png new file mode 100644 index 00000000..c0dbdcac Binary files /dev/null and b/docs/source/operations/projections/images/nell.png differ diff --git a/docs/source/operations/projections/images/nell_h.png b/docs/source/operations/projections/images/nell_h.png new file mode 100644 index 00000000..a5a27076 Binary files /dev/null and b/docs/source/operations/projections/images/nell_h.png differ diff --git a/docs/source/operations/projections/images/nicol.png b/docs/source/operations/projections/images/nicol.png new file mode 100644 index 00000000..711db115 Binary files /dev/null and b/docs/source/operations/projections/images/nicol.png differ diff --git a/docs/source/operations/projections/images/nsper.png b/docs/source/operations/projections/images/nsper.png new file mode 100644 index 00000000..06f210a1 Binary files /dev/null and b/docs/source/operations/projections/images/nsper.png differ diff --git a/docs/source/operations/projections/images/nzmg.png b/docs/source/operations/projections/images/nzmg.png new file mode 100644 index 00000000..3625f331 Binary files /dev/null and b/docs/source/operations/projections/images/nzmg.png differ diff --git a/docs/source/operations/projections/images/ob_tran.png b/docs/source/operations/projections/images/ob_tran.png new file mode 100644 index 00000000..9b1e0d44 Binary files /dev/null and b/docs/source/operations/projections/images/ob_tran.png differ diff --git a/docs/source/operations/projections/images/ocea.png b/docs/source/operations/projections/images/ocea.png new file mode 100644 index 00000000..41a5a813 Binary files /dev/null and b/docs/source/operations/projections/images/ocea.png differ diff --git a/docs/source/operations/projections/images/oea.png b/docs/source/operations/projections/images/oea.png new file mode 100644 index 00000000..601ead55 Binary files /dev/null and b/docs/source/operations/projections/images/oea.png differ diff --git a/docs/source/operations/projections/images/omerc.png b/docs/source/operations/projections/images/omerc.png new file mode 100644 index 00000000..50a3d2b7 Binary files /dev/null and b/docs/source/operations/projections/images/omerc.png differ diff --git a/docs/source/operations/projections/images/ortel.png b/docs/source/operations/projections/images/ortel.png new file mode 100644 index 00000000..c6a5bf4f Binary files /dev/null and b/docs/source/operations/projections/images/ortel.png differ diff --git a/docs/source/operations/projections/images/ortho.png b/docs/source/operations/projections/images/ortho.png new file mode 100644 index 00000000..e8b0b9b2 Binary files /dev/null and b/docs/source/operations/projections/images/ortho.png differ diff --git a/docs/source/operations/projections/images/patterson.png b/docs/source/operations/projections/images/patterson.png new file mode 100644 index 00000000..f8014249 Binary files /dev/null and b/docs/source/operations/projections/images/patterson.png differ diff --git a/docs/source/operations/projections/images/pconic.png b/docs/source/operations/projections/images/pconic.png new file mode 100644 index 00000000..7d7f9f92 Binary files /dev/null and b/docs/source/operations/projections/images/pconic.png differ diff --git a/docs/source/operations/projections/images/poly.png b/docs/source/operations/projections/images/poly.png new file mode 100644 index 00000000..ccf25529 Binary files /dev/null and b/docs/source/operations/projections/images/poly.png differ diff --git a/docs/source/operations/projections/images/putp1.png b/docs/source/operations/projections/images/putp1.png new file mode 100644 index 00000000..c81f574c Binary files /dev/null and b/docs/source/operations/projections/images/putp1.png differ diff --git a/docs/source/operations/projections/images/putp2.png b/docs/source/operations/projections/images/putp2.png new file mode 100644 index 00000000..377a027c Binary files /dev/null and b/docs/source/operations/projections/images/putp2.png differ diff --git a/docs/source/operations/projections/images/putp3.png b/docs/source/operations/projections/images/putp3.png new file mode 100644 index 00000000..08692ca1 Binary files /dev/null and b/docs/source/operations/projections/images/putp3.png differ diff --git a/docs/source/operations/projections/images/putp3p.png b/docs/source/operations/projections/images/putp3p.png new file mode 100644 index 00000000..9e42319c Binary files /dev/null and b/docs/source/operations/projections/images/putp3p.png differ diff --git a/docs/source/operations/projections/images/putp4p.png b/docs/source/operations/projections/images/putp4p.png new file mode 100644 index 00000000..43cb10c6 Binary files /dev/null and b/docs/source/operations/projections/images/putp4p.png differ diff --git a/docs/source/operations/projections/images/putp5.png b/docs/source/operations/projections/images/putp5.png new file mode 100644 index 00000000..4e45de6d Binary files /dev/null and b/docs/source/operations/projections/images/putp5.png differ diff --git a/docs/source/operations/projections/images/putp5p.png b/docs/source/operations/projections/images/putp5p.png new file mode 100644 index 00000000..76dcb767 Binary files /dev/null and b/docs/source/operations/projections/images/putp5p.png differ diff --git a/docs/source/operations/projections/images/putp6.png b/docs/source/operations/projections/images/putp6.png new file mode 100644 index 00000000..c73585ee Binary files /dev/null and b/docs/source/operations/projections/images/putp6.png differ diff --git a/docs/source/operations/projections/images/putp6p.png b/docs/source/operations/projections/images/putp6p.png new file mode 100644 index 00000000..d64c2c20 Binary files /dev/null and b/docs/source/operations/projections/images/putp6p.png differ diff --git a/docs/source/operations/projections/images/qsc.png b/docs/source/operations/projections/images/qsc.png new file mode 100644 index 00000000..5824cf64 Binary files /dev/null and b/docs/source/operations/projections/images/qsc.png differ diff --git a/docs/source/operations/projections/images/qua_aut.png b/docs/source/operations/projections/images/qua_aut.png new file mode 100644 index 00000000..6bc2d811 Binary files /dev/null and b/docs/source/operations/projections/images/qua_aut.png differ diff --git a/docs/source/operations/projections/images/rhealpix.png b/docs/source/operations/projections/images/rhealpix.png new file mode 100644 index 00000000..dc1c344a Binary files /dev/null and b/docs/source/operations/projections/images/rhealpix.png differ diff --git a/docs/source/operations/projections/images/robin.png b/docs/source/operations/projections/images/robin.png new file mode 100644 index 00000000..42a49da2 Binary files /dev/null and b/docs/source/operations/projections/images/robin.png differ diff --git a/docs/source/operations/projections/images/rouss.png b/docs/source/operations/projections/images/rouss.png new file mode 100644 index 00000000..2eca0fed Binary files /dev/null and b/docs/source/operations/projections/images/rouss.png differ diff --git a/docs/source/operations/projections/images/rpoly.png b/docs/source/operations/projections/images/rpoly.png new file mode 100644 index 00000000..343127c1 Binary files /dev/null and b/docs/source/operations/projections/images/rpoly.png differ diff --git a/docs/source/operations/projections/images/sinu.png b/docs/source/operations/projections/images/sinu.png new file mode 100644 index 00000000..9bef143a Binary files /dev/null and b/docs/source/operations/projections/images/sinu.png differ diff --git a/docs/source/operations/projections/images/somerc.png b/docs/source/operations/projections/images/somerc.png new file mode 100644 index 00000000..1248e6ea Binary files /dev/null and b/docs/source/operations/projections/images/somerc.png differ diff --git a/docs/source/operations/projections/images/stere.png b/docs/source/operations/projections/images/stere.png new file mode 100644 index 00000000..840050f0 Binary files /dev/null and b/docs/source/operations/projections/images/stere.png differ diff --git a/docs/source/operations/projections/images/sterea.png b/docs/source/operations/projections/images/sterea.png new file mode 100644 index 00000000..d2aad552 Binary files /dev/null and b/docs/source/operations/projections/images/sterea.png differ diff --git a/docs/source/operations/projections/images/tcc.png b/docs/source/operations/projections/images/tcc.png new file mode 100644 index 00000000..f968f62d Binary files /dev/null and b/docs/source/operations/projections/images/tcc.png differ diff --git a/docs/source/operations/projections/images/tcea.png b/docs/source/operations/projections/images/tcea.png new file mode 100644 index 00000000..44212bd8 Binary files /dev/null and b/docs/source/operations/projections/images/tcea.png differ diff --git a/docs/source/operations/projections/images/tissot.png b/docs/source/operations/projections/images/tissot.png new file mode 100644 index 00000000..2f785477 Binary files /dev/null and b/docs/source/operations/projections/images/tissot.png differ diff --git a/docs/source/operations/projections/images/tmerc.png b/docs/source/operations/projections/images/tmerc.png new file mode 100644 index 00000000..b206c502 Binary files /dev/null and b/docs/source/operations/projections/images/tmerc.png differ diff --git a/docs/source/operations/projections/images/tpeqd.png b/docs/source/operations/projections/images/tpeqd.png new file mode 100644 index 00000000..50291b68 Binary files /dev/null and b/docs/source/operations/projections/images/tpeqd.png differ diff --git a/docs/source/operations/projections/images/tpers.png b/docs/source/operations/projections/images/tpers.png new file mode 100644 index 00000000..480f6dce Binary files /dev/null and b/docs/source/operations/projections/images/tpers.png differ diff --git a/docs/source/operations/projections/images/ups.png b/docs/source/operations/projections/images/ups.png new file mode 100644 index 00000000..354b64ac Binary files /dev/null and b/docs/source/operations/projections/images/ups.png differ diff --git a/docs/source/operations/projections/images/urm5.png b/docs/source/operations/projections/images/urm5.png new file mode 100644 index 00000000..088671c9 Binary files /dev/null and b/docs/source/operations/projections/images/urm5.png differ diff --git a/docs/source/operations/projections/images/urmfps.png b/docs/source/operations/projections/images/urmfps.png new file mode 100644 index 00000000..86432790 Binary files /dev/null and b/docs/source/operations/projections/images/urmfps.png differ diff --git a/docs/source/operations/projections/images/utm.png b/docs/source/operations/projections/images/utm.png new file mode 100644 index 00000000..3dcd5ee0 Binary files /dev/null and b/docs/source/operations/projections/images/utm.png differ diff --git a/docs/source/operations/projections/images/vandg.png b/docs/source/operations/projections/images/vandg.png new file mode 100644 index 00000000..46fe2346 Binary files /dev/null and b/docs/source/operations/projections/images/vandg.png differ diff --git a/docs/source/operations/projections/images/vandg2.png b/docs/source/operations/projections/images/vandg2.png new file mode 100644 index 00000000..597b5ae1 Binary files /dev/null and b/docs/source/operations/projections/images/vandg2.png differ diff --git a/docs/source/operations/projections/images/vandg3.png b/docs/source/operations/projections/images/vandg3.png new file mode 100644 index 00000000..36d1ad04 Binary files /dev/null and b/docs/source/operations/projections/images/vandg3.png differ diff --git a/docs/source/operations/projections/images/vandg4.png b/docs/source/operations/projections/images/vandg4.png new file mode 100644 index 00000000..163c1558 Binary files /dev/null and b/docs/source/operations/projections/images/vandg4.png differ diff --git a/docs/source/operations/projections/images/vitk1.png b/docs/source/operations/projections/images/vitk1.png new file mode 100644 index 00000000..31034b3a Binary files /dev/null and b/docs/source/operations/projections/images/vitk1.png differ diff --git a/docs/source/operations/projections/images/wag1.png b/docs/source/operations/projections/images/wag1.png new file mode 100644 index 00000000..a2bc8adc Binary files /dev/null and b/docs/source/operations/projections/images/wag1.png differ diff --git a/docs/source/operations/projections/images/wag2.png b/docs/source/operations/projections/images/wag2.png new file mode 100644 index 00000000..b4abb48c Binary files /dev/null and b/docs/source/operations/projections/images/wag2.png differ diff --git a/docs/source/operations/projections/images/wag3.png b/docs/source/operations/projections/images/wag3.png new file mode 100644 index 00000000..a2053815 Binary files /dev/null and b/docs/source/operations/projections/images/wag3.png differ diff --git a/docs/source/operations/projections/images/wag4.png b/docs/source/operations/projections/images/wag4.png new file mode 100644 index 00000000..7d1c50b3 Binary files /dev/null and b/docs/source/operations/projections/images/wag4.png differ diff --git a/docs/source/operations/projections/images/wag5.png b/docs/source/operations/projections/images/wag5.png new file mode 100644 index 00000000..487f6022 Binary files /dev/null and b/docs/source/operations/projections/images/wag5.png differ diff --git a/docs/source/operations/projections/images/wag6.png b/docs/source/operations/projections/images/wag6.png new file mode 100644 index 00000000..dd49e8d0 Binary files /dev/null and b/docs/source/operations/projections/images/wag6.png differ diff --git a/docs/source/operations/projections/images/wag7.png b/docs/source/operations/projections/images/wag7.png new file mode 100644 index 00000000..b9682755 Binary files /dev/null and b/docs/source/operations/projections/images/wag7.png differ diff --git a/docs/source/operations/projections/images/weren.png b/docs/source/operations/projections/images/weren.png new file mode 100644 index 00000000..7deb132f Binary files /dev/null and b/docs/source/operations/projections/images/weren.png differ diff --git a/docs/source/operations/projections/images/wink1.png b/docs/source/operations/projections/images/wink1.png new file mode 100644 index 00000000..6cbf48ae Binary files /dev/null and b/docs/source/operations/projections/images/wink1.png differ diff --git a/docs/source/operations/projections/images/wink2.png b/docs/source/operations/projections/images/wink2.png new file mode 100644 index 00000000..21a23634 Binary files /dev/null and b/docs/source/operations/projections/images/wink2.png differ diff --git a/docs/source/operations/projections/images/wintri.png b/docs/source/operations/projections/images/wintri.png new file mode 100644 index 00000000..54a0a85a Binary files /dev/null and b/docs/source/operations/projections/images/wintri.png differ diff --git a/docs/source/operations/projections/imw_p.rst b/docs/source/operations/projections/imw_p.rst new file mode 100644 index 00000000..1fd3ded0 --- /dev/null +++ b/docs/source/operations/projections/imw_p.rst @@ -0,0 +1,10 @@ +.. _imw_p: + +******************************************************************************** +International Map of the World Polyconic +******************************************************************************** + +.. image:: ./images/imw_p.png + :scale: 50% + :alt: International Map of the World Polyconic + diff --git a/docs/source/operations/projections/index.rst b/docs/source/operations/projections/index.rst new file mode 100644 index 00000000..904dc9e6 --- /dev/null +++ b/docs/source/operations/projections/index.rst @@ -0,0 +1,146 @@ +.. _projections: + +================================================================================ +Projections +================================================================================ + +Projections are coordinate operations that are technically conversions but since +projections are so fundamental to PROJ we differentiate them from conversions. + +Projections map the spherical 3D space to a flat 2D space. + +.. toctree:: + :maxdepth: 1 + + aeqd + airy + aitoff + alsk + apian + august + bacon + bipc + boggs + bonne + calcofi + cass + cc + ccon + cea + chamb + collg + crast + denoy + eck1 + eck2 + eck3 + eck4 + eck5 + eck6 + eqc + eqdc + euler + etmerc + fahey + fouc + fouc_s + gall + geos + gins8 + gn_sinu + gnom + goode + gs48 + gs50 + hammer + hatano + healpix + rhealpix + igh + imw_p + isea + kav5 + kav7 + krovak + labrd + laea + lagrng + larr + lask + lcc + lcca + leac + lee_os + loxim + lsat + mbt_s + mbt_fps + mbtfpp + mbtfpq + mbtfps + merc + mil_os + mill + moll + murd1 + murd2 + murd3 + natearth + nell + nell_h + nicol + nsper + nzmg + ob_tran + ocea + oea + omerc + ortel + ortho + pconic + poly + putp1 + putp2 + putp3 + putp3p + putp4p + putp5 + putp5p + putp6 + putp6p + qua_aut + qsc + robin + rouss + rpoly + sinu + somerc + stere + sterea + gstmerc + tcc + tcea + tissot + tmerc + tpeqd + tpers + ups + urm5 + urmfps + utm + vandg + vandg2 + vandg3 + vandg4 + vitk1 + wag1 + wag2 + wag3 + wag4 + wag5 + wag6 + wag7 + weren + wink1 + wink2 + wintri diff --git a/docs/source/operations/projections/isea.rst b/docs/source/operations/projections/isea.rst new file mode 100644 index 00000000..1b6457af --- /dev/null +++ b/docs/source/operations/projections/isea.rst @@ -0,0 +1,10 @@ +.. _isea: + +******************************************************************************** +Icosahedral Snyder Equal Area +******************************************************************************** + +.. image:: ./images/isea.png + :scale: 50% + :alt: Icosahedral Snyder Equal Area + diff --git a/docs/source/operations/projections/kav5.rst b/docs/source/operations/projections/kav5.rst new file mode 100644 index 00000000..2ec5d1c1 --- /dev/null +++ b/docs/source/operations/projections/kav5.rst @@ -0,0 +1,10 @@ +.. _kav5: + +******************************************************************************** +Kavraisky V +******************************************************************************** + +.. image:: ./images/kav5.png + :scale: 50% + :alt: Kavraisky V + diff --git a/docs/source/operations/projections/kav7.rst b/docs/source/operations/projections/kav7.rst new file mode 100644 index 00000000..8371e6ea --- /dev/null +++ b/docs/source/operations/projections/kav7.rst @@ -0,0 +1,10 @@ +.. _kav7: + +******************************************************************************** +Kavraisky VII +******************************************************************************** + +.. image:: ./images/kav7.png + :scale: 50% + :alt: Kavraisky VII + diff --git a/docs/source/operations/projections/krovak.rst b/docs/source/operations/projections/krovak.rst new file mode 100644 index 00000000..6c774825 --- /dev/null +++ b/docs/source/operations/projections/krovak.rst @@ -0,0 +1,10 @@ +.. _krovak: + +******************************************************************************** +Krovak +******************************************************************************** + +.. image:: ./images/krovak.png + :scale: 50% + :alt: Krovak + diff --git a/docs/source/operations/projections/labrd.rst b/docs/source/operations/projections/labrd.rst new file mode 100644 index 00000000..5be58db5 --- /dev/null +++ b/docs/source/operations/projections/labrd.rst @@ -0,0 +1,10 @@ +.. _labrd: + +******************************************************************************** +Laborde +******************************************************************************** + +.. image:: ./images/labrd.png + :scale: 50% + :alt: Laborde + diff --git a/docs/source/operations/projections/laea.rst b/docs/source/operations/projections/laea.rst new file mode 100644 index 00000000..2377f294 --- /dev/null +++ b/docs/source/operations/projections/laea.rst @@ -0,0 +1,10 @@ +.. _laea: + +******************************************************************************** +Lambert Azimuthal Equal Area +******************************************************************************** + +.. image:: ./images/laea.png + :scale: 50% + :alt: Lambert Azimuthal Equal Area + diff --git a/docs/source/operations/projections/lagrng.rst b/docs/source/operations/projections/lagrng.rst new file mode 100644 index 00000000..de9e5640 --- /dev/null +++ b/docs/source/operations/projections/lagrng.rst @@ -0,0 +1,10 @@ +.. _lagrng: + +******************************************************************************** +Lagrange +******************************************************************************** + +.. image:: ./images/lagrng.png + :scale: 50% + :alt: Lagrange + diff --git a/docs/source/operations/projections/larr.rst b/docs/source/operations/projections/larr.rst new file mode 100644 index 00000000..9529f83f --- /dev/null +++ b/docs/source/operations/projections/larr.rst @@ -0,0 +1,10 @@ +.. _larr: + +******************************************************************************** +Larrivee +******************************************************************************** + +.. image:: ./images/larr.png + :scale: 50% + :alt: Larrivee + diff --git a/docs/source/operations/projections/lask.rst b/docs/source/operations/projections/lask.rst new file mode 100644 index 00000000..d34dc8a0 --- /dev/null +++ b/docs/source/operations/projections/lask.rst @@ -0,0 +1,10 @@ +.. _lask: + +******************************************************************************** +Laskowski +******************************************************************************** + +.. image:: ./images/lask.png + :scale: 50% + :alt: Laskowski + diff --git a/docs/source/operations/projections/lcc.rst b/docs/source/operations/projections/lcc.rst new file mode 100644 index 00000000..a3075e76 --- /dev/null +++ b/docs/source/operations/projections/lcc.rst @@ -0,0 +1,10 @@ +.. _lcc: + +******************************************************************************** +Lambert Conformal Conic +******************************************************************************** + +.. image:: ./images/lcc.png + :scale: 50% + :alt: Lambert Conformal Conic + diff --git a/docs/source/operations/projections/lcca.rst b/docs/source/operations/projections/lcca.rst new file mode 100644 index 00000000..ca87e67e --- /dev/null +++ b/docs/source/operations/projections/lcca.rst @@ -0,0 +1,10 @@ +.. _lcca: + +******************************************************************************** +Lambert Conformal Conic Alternative +******************************************************************************** + +.. image:: ./images/lcca.png + :scale: 50% + :alt: Lambert Conformal Conic Alternative + diff --git a/docs/source/operations/projections/leac.rst b/docs/source/operations/projections/leac.rst new file mode 100644 index 00000000..2957798e --- /dev/null +++ b/docs/source/operations/projections/leac.rst @@ -0,0 +1,10 @@ +.. _leac: + +******************************************************************************** +Lambert Equal Area Conic +******************************************************************************** + +.. image:: ./images/leac.png + :scale: 50% + :alt: Lambert Equal Area Conic + diff --git a/docs/source/operations/projections/lee_os.rst b/docs/source/operations/projections/lee_os.rst new file mode 100644 index 00000000..711dc754 --- /dev/null +++ b/docs/source/operations/projections/lee_os.rst @@ -0,0 +1,10 @@ +.. _lee_os: + +******************************************************************************** +Lee Oblated Stereographic +******************************************************************************** + +.. image:: ./images/lee_os.png + :scale: 50% + :alt: Lee Oblated Stereographic + diff --git a/docs/source/operations/projections/loxim.rst b/docs/source/operations/projections/loxim.rst new file mode 100644 index 00000000..e50ba472 --- /dev/null +++ b/docs/source/operations/projections/loxim.rst @@ -0,0 +1,10 @@ +.. _loxim: + +******************************************************************************** +Loximuthal +******************************************************************************** + +.. image:: ./images/loxim.png + :scale: 50% + :alt: Loximuthal + diff --git a/docs/source/operations/projections/lsat.rst b/docs/source/operations/projections/lsat.rst new file mode 100644 index 00000000..fb64bdb2 --- /dev/null +++ b/docs/source/operations/projections/lsat.rst @@ -0,0 +1,10 @@ +.. _lsat: + +******************************************************************************** +Space oblique for LANDSAT +******************************************************************************** + +.. image:: ./images/lsat.png + :scale: 50% + :alt: Space oblique for LANDSAT + diff --git a/docs/source/operations/projections/mbt_fps.rst b/docs/source/operations/projections/mbt_fps.rst new file mode 100644 index 00000000..55ebcf6c --- /dev/null +++ b/docs/source/operations/projections/mbt_fps.rst @@ -0,0 +1,10 @@ +.. _mbt_fps: + +******************************************************************************** +McBryde-Thomas Flat-Pole Sine (No. 2) +******************************************************************************** + +.. image:: ./images/mbt_fps.png + :scale: 50% + :alt: McBryde-Thomas Flat-Pole Sine (No. 2) + diff --git a/docs/source/operations/projections/mbt_s.rst b/docs/source/operations/projections/mbt_s.rst new file mode 100644 index 00000000..9a355ec8 --- /dev/null +++ b/docs/source/operations/projections/mbt_s.rst @@ -0,0 +1,10 @@ +.. _mbt_s: + +******************************************************************************** +McBryde-Thomas Flat-Polar Sine (No. 1) +******************************************************************************** + +.. image:: ./images/mbt_s.png + :scale: 50% + :alt: McBryde-Thomas Flat-Polar Sine (No. 1) + diff --git a/docs/source/operations/projections/mbtfpp.rst b/docs/source/operations/projections/mbtfpp.rst new file mode 100644 index 00000000..9be309d9 --- /dev/null +++ b/docs/source/operations/projections/mbtfpp.rst @@ -0,0 +1,10 @@ +.. _mbtfpp: + +******************************************************************************** +McBride-Thomas Flat-Polar Parabolic +******************************************************************************** + +.. image:: ./images/mbtfpp.png + :scale: 50% + :alt: McBride-Thomas Flat-Polar Parabolic + diff --git a/docs/source/operations/projections/mbtfpq.rst b/docs/source/operations/projections/mbtfpq.rst new file mode 100644 index 00000000..295e814d --- /dev/null +++ b/docs/source/operations/projections/mbtfpq.rst @@ -0,0 +1,10 @@ +.. _mbtfpq: + +******************************************************************************** +McBryde-Thomas Flat-Polar Quartic +******************************************************************************** + +.. image:: ./images/mbtfpq.png + :scale: 50% + :alt: McBryde-Thomas Flat-Polar Quartic + diff --git a/docs/source/operations/projections/mbtfps.rst b/docs/source/operations/projections/mbtfps.rst new file mode 100644 index 00000000..b9365361 --- /dev/null +++ b/docs/source/operations/projections/mbtfps.rst @@ -0,0 +1,10 @@ +.. _mbtfps: + +******************************************************************************** +McBryde-Thomas Flat-Polar Sinusoidal +******************************************************************************** + +.. image:: ./images/mbtfps.png + :scale: 50% + :alt: McBryde-Thomas Flat-Polar Sinusoidal + diff --git a/docs/source/operations/projections/merc.rst b/docs/source/operations/projections/merc.rst new file mode 100644 index 00000000..8895abc8 --- /dev/null +++ b/docs/source/operations/projections/merc.rst @@ -0,0 +1,140 @@ +.. _merc: + +******************************************************************************** +Mercator +******************************************************************************** + +The Mercator projection is a cylindrical map projection that origins from the 15th +century. It is widely recognized as the first regularly used map projection. +The projection is conformal which makes it suitable for navigational purposes. + + ++---------------------+----------------------------------------------------------+ +| **Classification** | Conformal cylindrical | ++---------------------+----------------------------------------------------------+ +| **Available forms** | Forward and inverse, spherical and elliptical projection | ++---------------------+----------------------------------------------------------+ +| **Defined area** | Global, but best used near the equator | ++---------------------+----------------------------------------------------------+ +| **Implemented by** | Gerald I. Evenden | ++---------------------+----------------------------------------------------------+ +| **Options** | ++---------------------+----------------------------------------------------------+ +| `+lat_ts` | Latitude of true scale. Defaults to 0.0 | ++---------------------+----------------------------------------------------------+ +| `+k_0` | Scaling factor. Defaults to 1.0 | ++---------------------+----------------------------------------------------------+ + + + +.. image:: ./images/merc.png + :scale: 50% + :alt: Mercator + + +Usage +######## + +Applications should be limited to equatorial regions, but is frequently +used for navigational charts with latitude of true scale (``+lat_ts``) specified within +or near chart's boundaries. +Often inappropriately used for world maps since the regions near the poles +cannot be shown [Evenden1995]_. + + +Example using latitude of true scale:: + + $ echo 56.35 12.32 | proj +proj=merc +lat_ts=56.5 + 3470306.37 759599.90 + +Example using scaling factor:: + + echo 56.35 12.32 | proj +proj=merc +k_0=2 + 12545706.61 2746073.80 + + +Note that ``+lat_ts`` and ``+k_0`` are mutually exclusive. +If used together, ``+lat_ts`` takes precedence over ``+k_0``. + +Mathematical definition +####################### + +The formulas describing the Mercator projection are all taken from G. Evenden's libproj manuals [Evenden2005]_. + +Spherical form +************** +For the spherical form of the projection we introduce the scaling factor: + +.. math:: + + k_0 = \cos \phi_{ts} + +Forward projection +================== + +.. math:: + + x = k_0 \lambda + +.. math:: + + y = k_0 \ln \left[ \tan \left(\frac{\pi}{4} + \frac{\phi}{2} \right) \right] + + +Inverse projection +================== + +.. math:: + + \lambda = \frac{x}{k_0} + +.. math:: + + \phi = \frac{\pi}{2} - 2 \arctan \left[ e^{-y/k_0} \right] + + +Elliptical form +*************** + +For the elliptical form of the projection we introduce the scaling factor: + +.. math:: + + k_0 = m\left( \phi_ts \right) + +where :math:`m\left(\phi\right)` is the parallel radius at latitude :math:`\phi`. + +We also use the Isometric Latitude kernel function :math:`t()`. + +.. note:: + m() and t() should be described properly on a separate page about the theory of projections on the ellipsoid. + +Forward projection +================== +.. math:: + + x = k_0 \lambda + +.. math:: + + y = k_0 \ln t \left( \phi \right) + + +Inverse projection +================== + +.. math:: + + \lambda = \frac{x}{k_0} + +.. math:: + + \phi = t^{-1}\left[ e^{ -y/k_0 } \right] + +Further reading +############### + +#. `Wikipedia `_ +#. `Wolfram Mathworld `_ + + diff --git a/docs/source/operations/projections/mil_os.rst b/docs/source/operations/projections/mil_os.rst new file mode 100644 index 00000000..5547e43c --- /dev/null +++ b/docs/source/operations/projections/mil_os.rst @@ -0,0 +1,10 @@ +.. _mil_os: + +******************************************************************************** +Miller Oblated Stereographic +******************************************************************************** + +.. image:: ./images/mil_os.png + :scale: 50% + :alt: Miller Oblated Stereographic + diff --git a/docs/source/operations/projections/mill.rst b/docs/source/operations/projections/mill.rst new file mode 100644 index 00000000..eb9c2092 --- /dev/null +++ b/docs/source/operations/projections/mill.rst @@ -0,0 +1,72 @@ +.. _mill: + +******************************************************************************** +Miller Cylindrical +******************************************************************************** + +The Miller cylindrical projection is a modified Mercator projection, proposed by Osborn Maitland Miller in 1942. +The latitude is scaled by a factor of :math:`\frac{4}{5}`, projected according to Mercator, and then the result is multiplied by :math:`\frac{5}{4}` to retain scale along the equator. + ++---------------------+--------------------------------------------------------------------------------+ +| **Classification** | Neither conformal nor equal area cylindrical | ++---------------------+--------------------------------------------------------------------------------+ +| **Available forms** | Forward and inverse spherical | ++---------------------+--------------------------------------------------------------------------------+ +| **Defined area** | Global, but best used near the equator | ++---------------------+--------------------------------------------------------------------------------+ +| **Implemented by** | Gerald I. Evenden | ++---------------------+--------------------------------------------------------------------------------+ +| **Options** | ++---------------------+--------------------------------------------------------------------------------+ +| `+lat_0` | Latitude of origin (Default to 0) | ++---------------------+--------------------------------------------------------------------------------+ + +.. image:: ./images/mill.png + :scale: 50% + :alt: Miller Cylindrical + +Usage +######## + +The Miller Cylindrical projection is used for world maps and in several atlases, +including the National Atlas of the United States (USGS, 1970, p. 330-331) [Snyder1987]_. + +Example using Central meridian 90°W:: + + $ echo -100 35 | proj +proj=mill +lon_0=90w + -1113194.91 4061217.24 + +Mathematical definition +####################### + +The formulas describing the Miller projection are all taken from Snyder's manuals [Snyder1987]_. + + +Forward projection +================== + +.. math:: + + x = \lambda + +.. math:: + + y = 1.25 * \ln \left[ \tan \left(\frac{\pi}{4} + 0.4 * \phi \right) \right] + + +Inverse projection +================== + +.. math:: + + \lambda = x + +.. math:: + + \phi = 2.5 * ( \arctan \left[ e^{0.8 * y} \right] - \frac{\pi}{4} ) + +Further reading +############### + +#. `Wikipedia `_ + diff --git a/docs/source/operations/projections/moll.rst b/docs/source/operations/projections/moll.rst new file mode 100644 index 00000000..1bd3d005 --- /dev/null +++ b/docs/source/operations/projections/moll.rst @@ -0,0 +1,10 @@ +.. _moll: + +******************************************************************************** +Mollweide +******************************************************************************** + +.. image:: ./images/moll.png + :scale: 50% + :alt: Mollweide + diff --git a/docs/source/operations/projections/murd1.rst b/docs/source/operations/projections/murd1.rst new file mode 100644 index 00000000..71cbf155 --- /dev/null +++ b/docs/source/operations/projections/murd1.rst @@ -0,0 +1,10 @@ +.. _murd1: + +******************************************************************************** +Murdoch I +******************************************************************************** + +.. image:: ./images/murd1.png + :scale: 50% + :alt: Murdoch I + diff --git a/docs/source/operations/projections/murd2.rst b/docs/source/operations/projections/murd2.rst new file mode 100644 index 00000000..b55cde35 --- /dev/null +++ b/docs/source/operations/projections/murd2.rst @@ -0,0 +1,10 @@ +.. _murd2: + +******************************************************************************** +Murdoch II +******************************************************************************** + +.. image:: ./images/murd2.png + :scale: 50% + :alt: Murdoch II + diff --git a/docs/source/operations/projections/murd3.rst b/docs/source/operations/projections/murd3.rst new file mode 100644 index 00000000..70cc9276 --- /dev/null +++ b/docs/source/operations/projections/murd3.rst @@ -0,0 +1,10 @@ +.. _murd3: + +******************************************************************************** +Murdoch III +******************************************************************************** + +.. image:: ./images/murd3.png + :scale: 50% + :alt: Murdoch III + diff --git a/docs/source/operations/projections/natearth.rst b/docs/source/operations/projections/natearth.rst new file mode 100644 index 00000000..57dd96db --- /dev/null +++ b/docs/source/operations/projections/natearth.rst @@ -0,0 +1,47 @@ +.. _natearth: + +******************************************************************************** +Natural Earth +******************************************************************************** ++---------------------+--------------------------------------------------------+ +| **Classification** | Pseudo cylindrical | ++---------------------+--------------------------------------------------------+ +| **Available forms** | Forward and inverse, spherical projection | ++---------------------+--------------------------------------------------------+ +| **Defined area** | Global | ++---------------------+--------------------------------------------------------+ +| **Implemented by** | Bernhard Jenny | ++---------------------+--------------------------------------------------------+ +| **Options** | ++---------------------+--------------------------------------------------------+ +| `No special options for this projection` | ++---------------------+--------------------------------------------------------+ + +.. image:: ./images/natearth.png + :scale: 50% + :alt: Natural Earth + + +The Natural Earth projection is intended for making world maps. A distinguishing trait +is its slightly rounded corners fashioned to emulate the spherical shape of Earth. +The meridians (except for the central meridian) bend acutely inward as they approach +the pole lines, giving the projection a hint of three-dimensionality. This bending +also suggests that the meridians converge at the poles instead of truncating at the +top and bottom edges. The distortion characteristics of the Natural Earth projection +compare favorably to other world map projections. + + +Usage +############################################################################### + +The Natural Earth projection has no special options so usage is simple. Here is +an example of an inverse projection on a sphere with a radius of 7500 m:: + + $ echo 3500 -8000 | proj -I +proj=natearth +a=7500 + 37d54'6.091"E 61d23'4.582"S + + +Further reading +################################################################################ + +#. `Wikipedia `_ diff --git a/docs/source/operations/projections/nell.rst b/docs/source/operations/projections/nell.rst new file mode 100644 index 00000000..c6a3771c --- /dev/null +++ b/docs/source/operations/projections/nell.rst @@ -0,0 +1,10 @@ +.. _nell: + +******************************************************************************** +Nell +******************************************************************************** + +.. image:: ./images/nell.png + :scale: 50% + :alt: Nell + diff --git a/docs/source/operations/projections/nell_h.rst b/docs/source/operations/projections/nell_h.rst new file mode 100644 index 00000000..6a3b26ba --- /dev/null +++ b/docs/source/operations/projections/nell_h.rst @@ -0,0 +1,10 @@ +.. _nell_h: + +******************************************************************************** +Nell-Hammer +******************************************************************************** + +.. image:: ./images/nell_h.png + :scale: 50% + :alt: Nell-Hammer + diff --git a/docs/source/operations/projections/nicol.rst b/docs/source/operations/projections/nicol.rst new file mode 100644 index 00000000..995cedb5 --- /dev/null +++ b/docs/source/operations/projections/nicol.rst @@ -0,0 +1,10 @@ +.. _nicol: + +******************************************************************************** +Nicolosi Globular +******************************************************************************** + +.. image:: ./images/nicol.png + :scale: 50% + :alt: Nicolosi Globular + diff --git a/docs/source/operations/projections/nsper.rst b/docs/source/operations/projections/nsper.rst new file mode 100644 index 00000000..4a8651fc --- /dev/null +++ b/docs/source/operations/projections/nsper.rst @@ -0,0 +1,10 @@ +.. _nsper: + +******************************************************************************** +Near-sided perspective +******************************************************************************** + +.. image:: ./images/nsper.png + :scale: 50% + :alt: Near-sided perspective + diff --git a/docs/source/operations/projections/nzmg.rst b/docs/source/operations/projections/nzmg.rst new file mode 100644 index 00000000..926655d8 --- /dev/null +++ b/docs/source/operations/projections/nzmg.rst @@ -0,0 +1,10 @@ +.. _nzmg: + +******************************************************************************** +New Zealand Map Grid +******************************************************************************** + +.. image:: ./images/nzmg.png + :scale: 50% + :alt: New Zealand Map Grid + diff --git a/docs/source/operations/projections/ob_tran.rst b/docs/source/operations/projections/ob_tran.rst new file mode 100644 index 00000000..3c996336 --- /dev/null +++ b/docs/source/operations/projections/ob_tran.rst @@ -0,0 +1,10 @@ +.. _ob_tran: + +******************************************************************************** +General Oblique Transformation +******************************************************************************** + +.. image:: ./images/ob_tran.png + :scale: 50% + :alt: General Oblique Transformation + diff --git a/docs/source/operations/projections/ocea.rst b/docs/source/operations/projections/ocea.rst new file mode 100644 index 00000000..40005d9e --- /dev/null +++ b/docs/source/operations/projections/ocea.rst @@ -0,0 +1,10 @@ +.. _ocea: + +******************************************************************************** +Oblique Cylindrical Equal Area +******************************************************************************** + +.. image:: ./images/ocea.png + :scale: 50% + :alt: Oblique Cylindrical Equal Area + diff --git a/docs/source/operations/projections/oea.rst b/docs/source/operations/projections/oea.rst new file mode 100644 index 00000000..379dc157 --- /dev/null +++ b/docs/source/operations/projections/oea.rst @@ -0,0 +1,10 @@ +.. _oea: + +******************************************************************************** +Oblated Equal Area +******************************************************************************** + +.. image:: ./images/oea.png + :scale: 50% + :alt: Oblated Equal Area + diff --git a/docs/source/operations/projections/omerc.rst b/docs/source/operations/projections/omerc.rst new file mode 100644 index 00000000..114b9fa3 --- /dev/null +++ b/docs/source/operations/projections/omerc.rst @@ -0,0 +1,10 @@ +.. _omerc: + +******************************************************************************** +Oblique Mercator +******************************************************************************** + +.. image:: ./images/omerc.png + :scale: 50% + :alt: Oblique Mercator + diff --git a/docs/source/operations/projections/ortel.rst b/docs/source/operations/projections/ortel.rst new file mode 100644 index 00000000..03f132ef --- /dev/null +++ b/docs/source/operations/projections/ortel.rst @@ -0,0 +1,10 @@ +.. _ortel: + +******************************************************************************** +Ortelius Oval +******************************************************************************** + +.. image:: ./images/ortel.png + :scale: 50% + :alt: Ortelius Oval + diff --git a/docs/source/operations/projections/ortho.rst b/docs/source/operations/projections/ortho.rst new file mode 100644 index 00000000..131dbfc7 --- /dev/null +++ b/docs/source/operations/projections/ortho.rst @@ -0,0 +1,10 @@ +.. _ortho: + +******************************************************************************** +Orthographic +******************************************************************************** + +.. image:: ./images/ortho.png + :scale: 50% + :alt: Orthographic + diff --git a/docs/source/operations/projections/pconic.rst b/docs/source/operations/projections/pconic.rst new file mode 100644 index 00000000..6bc0018e --- /dev/null +++ b/docs/source/operations/projections/pconic.rst @@ -0,0 +1,10 @@ +.. _pconic: + +******************************************************************************** +Perspective Conic +******************************************************************************** + +.. image:: ./images/pconic.png + :scale: 50% + :alt: Perspective Conic + diff --git a/docs/source/operations/projections/poly.rst b/docs/source/operations/projections/poly.rst new file mode 100644 index 00000000..e252feb5 --- /dev/null +++ b/docs/source/operations/projections/poly.rst @@ -0,0 +1,10 @@ +.. _poly: + +******************************************************************************** +Polyconic (American) +******************************************************************************** + +.. image:: ./images/poly.png + :scale: 50% + :alt: Polyconic (American) + diff --git a/docs/source/operations/projections/putp1.rst b/docs/source/operations/projections/putp1.rst new file mode 100644 index 00000000..68971a46 --- /dev/null +++ b/docs/source/operations/projections/putp1.rst @@ -0,0 +1,10 @@ +.. _putp1: + +******************************************************************************** +Putnins P1 +******************************************************************************** + +.. image:: ./images/putp1.png + :scale: 50% + :alt: Putnins P1 + diff --git a/docs/source/operations/projections/putp2.rst b/docs/source/operations/projections/putp2.rst new file mode 100644 index 00000000..01ea8073 --- /dev/null +++ b/docs/source/operations/projections/putp2.rst @@ -0,0 +1,10 @@ +.. _putp2: + +******************************************************************************** +Putnins P2 +******************************************************************************** + +.. image:: ./images/putp2.png + :scale: 50% + :alt: Putnins P2 + diff --git a/docs/source/operations/projections/putp3.rst b/docs/source/operations/projections/putp3.rst new file mode 100644 index 00000000..3aa6b9e6 --- /dev/null +++ b/docs/source/operations/projections/putp3.rst @@ -0,0 +1,10 @@ +.. _putp3: + +******************************************************************************** +Putnins P3 +******************************************************************************** + +.. image:: ./images/putp3.png + :scale: 50% + :alt: Putnins P3 + diff --git a/docs/source/operations/projections/putp3p.rst b/docs/source/operations/projections/putp3p.rst new file mode 100644 index 00000000..5b87512e --- /dev/null +++ b/docs/source/operations/projections/putp3p.rst @@ -0,0 +1,10 @@ +.. _putp3p: + +******************************************************************************** +Putnins P3' +******************************************************************************** + +.. image:: ./images/putp3p.png + :scale: 50% + :alt: Putnins P3' + diff --git a/docs/source/operations/projections/putp4p.rst b/docs/source/operations/projections/putp4p.rst new file mode 100644 index 00000000..b211ad9b --- /dev/null +++ b/docs/source/operations/projections/putp4p.rst @@ -0,0 +1,10 @@ +.. _putp4p: + +******************************************************************************** +Putnins P4' +******************************************************************************** + +.. image:: ./images/putp4p.png + :scale: 50% + :alt: Putnins P4' + diff --git a/docs/source/operations/projections/putp5.rst b/docs/source/operations/projections/putp5.rst new file mode 100644 index 00000000..5b60a961 --- /dev/null +++ b/docs/source/operations/projections/putp5.rst @@ -0,0 +1,10 @@ +.. _putp5: + +******************************************************************************** +Putnins P5 +******************************************************************************** + +.. image:: ./images/putp5.png + :scale: 50% + :alt: Putnins P5 + diff --git a/docs/source/operations/projections/putp5p.rst b/docs/source/operations/projections/putp5p.rst new file mode 100644 index 00000000..f586b889 --- /dev/null +++ b/docs/source/operations/projections/putp5p.rst @@ -0,0 +1,10 @@ +.. _putp5p: + +******************************************************************************** +Putnins P5' +******************************************************************************** + +.. image:: ./images/putp5p.png + :scale: 50% + :alt: Putnins P5' + diff --git a/docs/source/operations/projections/putp6.rst b/docs/source/operations/projections/putp6.rst new file mode 100644 index 00000000..94683ace --- /dev/null +++ b/docs/source/operations/projections/putp6.rst @@ -0,0 +1,10 @@ +.. _putp6: + +******************************************************************************** +Putnins P6 +******************************************************************************** + +.. image:: ./images/putp6.png + :scale: 50% + :alt: Putnins P6 + diff --git a/docs/source/operations/projections/putp6p.rst b/docs/source/operations/projections/putp6p.rst new file mode 100644 index 00000000..8c3add71 --- /dev/null +++ b/docs/source/operations/projections/putp6p.rst @@ -0,0 +1,10 @@ +.. _putp6p: + +******************************************************************************** +Putnins P6' +******************************************************************************** + +.. image:: ./images/putp6p.png + :scale: 50% + :alt: Putnins P6' + diff --git a/docs/source/operations/projections/qsc.rst b/docs/source/operations/projections/qsc.rst new file mode 100644 index 00000000..740901e8 --- /dev/null +++ b/docs/source/operations/projections/qsc.rst @@ -0,0 +1,158 @@ +.. _qsc: + +******************************************************************************** +Quadrilateralized Spherical Cube +******************************************************************************** + ++---------------------+----------------------------------------------------------+ +| **Classification** | Azimuthal | ++---------------------+----------------------------------------------------------+ +| **Available forms** | Forward and inverse, elliptical projection | ++---------------------+----------------------------------------------------------+ +| **Defined area** | Global | ++---------------------+----------------------------------------------------------+ +| **Implemented by** | Martin Lambers | ++---------------------+----------------------------------------------------------+ +| **Options** | ++---------------------+----------------------------------------------------------+ +| `+lat_0` | Latitude (in degrees) of the view position. | ++---------------------+----------------------------------------------------------+ +| `+lon_0` | Longitude (in degrees) of the view position. | ++---------------------+----------------------------------------------------------+ + +The purpose of the Quadrilateralized Spherical Cube (QSC) projection is to project +a sphere surface onto the six sides of a cube: + +.. image:: ../../../images/qsc_concept.jpg + :scale: 50% + :align: center + :alt: Quadrilateralized Spherical Cube + +For this purpose, other alternatives can be used, notably :ref:`gnom` or +:ref:`healpix`. However, QSC projection has the following favorable properties: + +It is an equal-area projection, and at the same time introduces only limited angular +distortions. It treats all cube sides equally, i.e. it does not use different +projections for polar areas and equatorial areas. These properties make QSC +projection a good choice for planetary-scale terrain rendering. Map data can be +organized in quadtree structures for each cube side. See [LambersKolb2012]_ for an example. + +The QSC projection was introduced by [ONeilLaubscher1976]_, +building on previous work by [ChanONeil1975]_. For clarity: The +earlier QSC variant described in [ChanONeil1975]_ became known as the COBE QSC since it +was used by the NASA Cosmic Background Explorer (COBE) project; it is an approximately +equal-area projection and is not the same as the QSC projection. + +See also [CalabrettaGreisen2002]_ Sec. 5.6.2 and 5.6.3 for a description of both and +some analysis. + +In this implementation, the QSC projection projects onto one side of a circumscribed +cube. The cube side is selected by choosing one of the following six projection centers: + ++-------------------------+--------------------+ +| ``+lat_0=0 +lon_0=0`` | front cube side | ++-------------------------+--------------------+ +| ``+lat_0=0 +lon_0=90`` | right cube side | ++-------------------------+--------------------+ +| ``+lat_0=0 +lon_0=180`` | back cube side | ++-------------------------+--------------------+ +| ``+lat_0=0 +lon_0=-90`` | left cube side | ++-------------------------+--------------------+ +| ``+lat_0=90`` | top cube side | ++-------------------------+--------------------+ +| ``+lat_0=-90`` | bottom cube side | ++-------------------------+--------------------+ + +Furthermore, this implementation allows the projection to be applied to ellipsoids. +A preceding shift to a sphere is performed automatically; see [LambersKolb2012]_ for details. + + +Usage +############################################################################### + +The following example uses QSC projection via GDAL to create the six cube side +maps from a world map for the WGS84 ellipsoid:: + + gdalwarp -t_srs "+wktext +proj=qsc +units=m +ellps=WGS84 +lat_0=0 +lon_0=0" \ + -wo SOURCE_EXTRA=100 -wo SAMPLE_GRID=YES -te -6378137 -6378137 6378137 6378137 \ + worldmap.tiff frontside.tiff + + gdalwarp -t_srs "+wktext +proj=qsc +units=m +ellps=WGS84 +lat_0=0 +lon_0=90" \ + -wo SOURCE_EXTRA=100 -wo SAMPLE_GRID=YES -te -6378137 -6378137 6378137 6378137 \ + worldmap.tiff rightside.tiff + + gdalwarp -t_srs "+wktext +proj=qsc +units=m +ellps=WGS84 +lat_0=0 +lon_0=180" \ + -wo SOURCE_EXTRA=100 -wo SAMPLE_GRID=YES -te -6378137 -6378137 6378137 6378137 \ + worldmap.tiff backside.tiff + + gdalwarp -t_srs "+wktext +proj=qsc +units=m +ellps=WGS84 +lat_0=0 +lon_0=-90" \ + -wo SOURCE_EXTRA=100 -wo SAMPLE_GRID=YES -te -6378137 -6378137 6378137 6378137 \ + worldmap.tiff leftside.tiff + + gdalwarp -t_srs "+wktext +proj=qsc +units=m +ellps=WGS84 +lat_0=90 +lon_0=0" \ + -wo SOURCE_EXTRA=100 -wo SAMPLE_GRID=YES -te -6378137 -6378137 6378137 6378137 \ + worldmap.tiff topside.tiff + + gdalwarp -t_srs "+wktext +proj=qsc +units=m +ellps=WGS84 +lat_0=-90 +lon_0=0" \ + -wo SOURCE_EXTRA=100 -wo SAMPLE_GRID=YES -te -6378137 -6378137 6378137 6378137 \ + worldmap.tiff bottomside.tiff + + +Explanation: + +* QSC projection is selected with ``+wktext +proj=qsc``. +* The WGS84 ellipsoid is specified with ``+ellps=WGS84``. +* The cube side is selected with ``+lat_0=... +lon_0=...``. +* The ``-wo`` options are necessary for GDAL to avoid holes in the output maps. +* The ``-te`` option limits the extends of the output map to the major axis diameter + (from -radius to +radius in both x and y direction). These are the dimensions of one side + of the circumscribing cube. + + +The resulting images can be laid out in a grid like below. + + +.. |topside| image:: ../../../images/qsc_topside.jpg + :scale: 50% + :align: middle + :alt: Top side + +.. |leftside| image:: ../../../images/qsc_leftside.jpg + :scale: 50% + :align: middle + :alt: Left side + +.. |frontside| image:: ../../../images/qsc_frontside.jpg + :scale: 50% + :align: middle + :alt: Front side + +.. |rightside| image:: ../../../images/qsc_rightside.jpg + :scale: 50% + :align: middle + :alt: Right side + +.. |backside| image:: ../../../images/qsc_backside.jpg + :scale: 50% + :align: middle + :alt: Back side + +.. |bottomside| image:: ../../../images/qsc_bottomside.jpg + :scale: 50% + :align: middle + :alt: Bottom side + + ++------------+--------------+-------------+------------+ +| | |topside| | | | ++------------+--------------+-------------+------------+ +| |leftside| | |frontside| | |rightside| | |backside| | ++------------+--------------+-------------+------------+ +| | |bottomside| | | | ++------------+--------------+-------------+------------+ + +Further reading +################################################################################ + +#. `Wikipedia `_ +#. `NASA `_ diff --git a/docs/source/operations/projections/qua_aut.rst b/docs/source/operations/projections/qua_aut.rst new file mode 100644 index 00000000..d3a0aece --- /dev/null +++ b/docs/source/operations/projections/qua_aut.rst @@ -0,0 +1,10 @@ +.. _qua_aut: + +******************************************************************************** +Quartic Authalic +******************************************************************************** + +.. image:: ./images/qua_aut.png + :scale: 50% + :alt: Quartic Authalic + diff --git a/docs/source/operations/projections/rhealpix.rst b/docs/source/operations/projections/rhealpix.rst new file mode 100644 index 00000000..52a913a5 --- /dev/null +++ b/docs/source/operations/projections/rhealpix.rst @@ -0,0 +1,51 @@ +.. _rhealpix: + +******************************************************************************** +rHEALPix +******************************************************************************** ++---------------------+----------------------------------------------------------+ +| **Classification** | Mixed | ++---------------------+----------------------------------------------------------+ +| **Available forms** | Forward and inverse, spherical and elliptical projection | ++---------------------+----------------------------------------------------------+ +| **Defined area** | Global | ++---------------------+----------------------------------------------------------+ +| **Implemented by** | Alex Raichev and Michael Speth | ++---------------------+----------------------------------------------------------+ +| **Options** | ++---------------------+----------------------------------------------------------+ +| `+north_square` | Position of the north polar square. | +| | Valid inputs are 0--3. Defaults to 0. | ++---------------------+----------------------------------------------------------+ +| `+south_square` | Position of the south polar square. | +| | Valid inputs are 0--3. Defaults to 0. | ++---------------------+----------------------------------------------------------+ + +.. image:: ../../../images/rhealpix.png + :scale: 75% + :alt: rHEALPix + +rHEALPix is a projection based on the HEALPix projection. The implementation of +rHEALPix uses the HEALPix projection. The rHEALPix combines the peaks of the +HEALPix into a square. The square's position can be translated and rotated across +the x-axis which is a novel approach for the rHEALPix projection. The initial +intention of using rHEALPix in the Spatial Computation Engine Science Collaboration +Environment (SCENZGrid). + +Usage +############################################################################### + +To run a rHEALPix projection on a WGS84 ellipsoidal model, use the following +command:: + + proj +proj=rhealpix -f '%.2f' +ellps=WGS84 +south_square=0 +north_square=2 -E << EOF + > 55 12 + > EOF + 55 12 6115727.86 1553840.13 + + +Further reading +################################################################################ + +#. `NASA `_ +#. `Wikipedia `_ diff --git a/docs/source/operations/projections/robin.rst b/docs/source/operations/projections/robin.rst new file mode 100644 index 00000000..3e58be46 --- /dev/null +++ b/docs/source/operations/projections/robin.rst @@ -0,0 +1,10 @@ +.. _robin: + +******************************************************************************** +Robinson +******************************************************************************** + +.. image:: ./images/robin.png + :scale: 50% + :alt: Robinson + diff --git a/docs/source/operations/projections/rouss.rst b/docs/source/operations/projections/rouss.rst new file mode 100644 index 00000000..e27fb1cf --- /dev/null +++ b/docs/source/operations/projections/rouss.rst @@ -0,0 +1,10 @@ +.. _rouss: + +******************************************************************************** +Roussilhe Stereographic +******************************************************************************** + +.. image:: ./images/rouss.png + :scale: 50% + :alt: Roussilhe Stereographic + diff --git a/docs/source/operations/projections/rpoly.rst b/docs/source/operations/projections/rpoly.rst new file mode 100644 index 00000000..80e0d640 --- /dev/null +++ b/docs/source/operations/projections/rpoly.rst @@ -0,0 +1,10 @@ +.. _rpoly: + +******************************************************************************** +Rectangular Polyconic +******************************************************************************** + +.. image:: ./images/rpoly.png + :scale: 50% + :alt: Rectangular Polyconic + diff --git a/docs/source/operations/projections/sinu.rst b/docs/source/operations/projections/sinu.rst new file mode 100644 index 00000000..a7ebd232 --- /dev/null +++ b/docs/source/operations/projections/sinu.rst @@ -0,0 +1,24 @@ +.. _sinu: + +******************************************************************************** +Sinusoidal (Sanson-Flamsteed) +******************************************************************************** + +.. image:: ./images/sinu.png + :scale: 50% + :alt: Sinusoidal (Sanson-Flamsteed) + +MacBryde and Thomas developed generalized formulas for sever of the +pseudocylindricals with sinusoidal meridians: + +.. math:: + + x = C\lambda(m+cos\theta) / ( m + 1) + +.. math:: + y = C\theta + +.. math:: + + C = \sqrt { (m + 1 ) / n } + diff --git a/docs/source/operations/projections/somerc.rst b/docs/source/operations/projections/somerc.rst new file mode 100644 index 00000000..c572622b --- /dev/null +++ b/docs/source/operations/projections/somerc.rst @@ -0,0 +1,10 @@ +.. _somerc: + +******************************************************************************** +Swiss. Obl. Mercator +******************************************************************************** + +.. image:: ./images/somerc.png + :scale: 50% + :alt: Swiss. Obl. Mercator + diff --git a/docs/source/operations/projections/stere.rst b/docs/source/operations/projections/stere.rst new file mode 100644 index 00000000..d4958ec9 --- /dev/null +++ b/docs/source/operations/projections/stere.rst @@ -0,0 +1,10 @@ +.. _stere: + +******************************************************************************** +Stereographic +******************************************************************************** + +.. image:: ./images/stere.png + :scale: 50% + :alt: Stereographic + diff --git a/docs/source/operations/projections/sterea.rst b/docs/source/operations/projections/sterea.rst new file mode 100644 index 00000000..4f2f8727 --- /dev/null +++ b/docs/source/operations/projections/sterea.rst @@ -0,0 +1,10 @@ +.. _sterea: + +******************************************************************************** +Oblique Stereographic Alternative +******************************************************************************** + +.. image:: ./images/sterea.png + :scale: 50% + :alt: Oblique Stereographic Alternative + diff --git a/docs/source/operations/projections/tcc.rst b/docs/source/operations/projections/tcc.rst new file mode 100644 index 00000000..586dd3b8 --- /dev/null +++ b/docs/source/operations/projections/tcc.rst @@ -0,0 +1,10 @@ +.. _tcc: + +******************************************************************************** +Transverse Central Cylindrical +******************************************************************************** + +.. image:: ./images/tcc.png + :scale: 50% + :alt: Transverse Central Cylindrical + diff --git a/docs/source/operations/projections/tcea.rst b/docs/source/operations/projections/tcea.rst new file mode 100644 index 00000000..cf5549a3 --- /dev/null +++ b/docs/source/operations/projections/tcea.rst @@ -0,0 +1,10 @@ +.. _tcea: + +******************************************************************************** +Transverse Cylindrical Equal Area +******************************************************************************** + +.. image:: ./images/tcea.png + :scale: 50% + :alt: Transverse Cylindrical Equal Area + diff --git a/docs/source/operations/projections/tissot.rst b/docs/source/operations/projections/tissot.rst new file mode 100644 index 00000000..7ec1a741 --- /dev/null +++ b/docs/source/operations/projections/tissot.rst @@ -0,0 +1,10 @@ +.. _tissot: + +******************************************************************************** +Tissot +******************************************************************************** + +.. image:: ./images/tissot.png + :scale: 50% + :alt: Tissot + diff --git a/docs/source/operations/projections/tmerc.rst b/docs/source/operations/projections/tmerc.rst new file mode 100644 index 00000000..1fc0cd7e --- /dev/null +++ b/docs/source/operations/projections/tmerc.rst @@ -0,0 +1,197 @@ +.. _tmerc: + +******************************************************************************** +Transverse Mercator +******************************************************************************** + +The transverse Mercator projection in its various forms is the most widely used projected coordinate system for world topographical and offshore mapping. + ++---------------------+--------------------------------------------------------------------------------+ +| **Classification** | Transverse and oblique cylindrical | ++---------------------+--------------------------------------------------------------------------------+ +| **Available forms** | Forward and inverse, Spherical and Elliptical | ++---------------------+--------------------------------------------------------------------------------+ +| **Defined area** | Global, but reasonably accurate only within 15 degrees of the central meridian | ++---------------------+--------------------------------------------------------------------------------+ +| **Implemented by** | Gerald I. Evenden | ++---------------------+--------------------------------------------------------------------------------+ +| **Options** | ++---------------------+--------------------------------------------------------------------------------+ +| `+lat_0` | Latitude of origin (Default to 0) | ++---------------------+--------------------------------------------------------------------------------+ +| `+k0` | Scale factor at natural origin (Default to 1) | ++---------------------+--------------------------------------------------------------------------------+ + + +.. image:: ./images/tmerc.png + :scale: 50% + :alt: Transverse Mercator + +Usage +##### + + +Prior to the development of the Universal Transverse Mercator coordinate system, several European nations demonstrated the utility of grid-based conformal maps by mapping their territory during the interwar period. +Calculating the distance between two points on these maps could be performed more easily in the field (using the Pythagorean theorem) than was possible using the trigonometric formulas required under the graticule-based system of latitude and longitude. +In the post-war years, these concepts were extended into the Universal Transverse Mercator/Universal Polar Stereographic (UTM/UPS) coordinate system, which is a global (or universal) system of grid-based maps. + +The following table gives special cases of the Transverse Mercator projection. + ++-------------------------------------+-----------------------------------------------------+--------------------------------+------------------------------------------+--------------+ +| Projection Name | Areas | Central meridian | Zone width | Scale Factor | ++-------------------------------------+-----------------------------------------------------+--------------------------------+------------------------------------------+--------------+ +| Transverse Mercator | World wide | Various | less than 6° | Various | ++-------------------------------------+-----------------------------------------------------+--------------------------------+------------------------------------------+--------------+ +| Transverse Mercator south oriented | Southern Africa | 2° intervals E of 11°E | 2° | 1.000 | ++-------------------------------------+-----------------------------------------------------+--------------------------------+------------------------------------------+--------------+ +| UTM North hemisphere | World wide equator to 84°N | 6° intervals E & W of 3° E & W | Always 6° | 0.9996 | ++-------------------------------------+-----------------------------------------------------+--------------------------------+------------------------------------------+--------------+ +| UTM South hemisphere | World wide north of 80°S to equator | 6° intervals E & W of 3° E & W | Always 6° | 0.9996 | ++-------------------------------------+-----------------------------------------------------+--------------------------------+------------------------------------------+--------------+ +| Gauss-Kruger | Former USSR, Yugoslavia, Germany, S. America, China | Various, according to area | Usually less than 6°, often less than 4° | 1.0000 | ++-------------------------------------+-----------------------------------------------------+--------------------------------+------------------------------------------+--------------+ +| Gauss Boaga | Italy | Various, according to area | 6° | 0.9996 | ++-------------------------------------+-----------------------------------------------------+--------------------------------+------------------------------------------+--------------+ + + + +Example using Gauss-Kruger on Germany area (aka EPSG:31467) :: + + $ echo 9 51 | proj +proj=tmerc +lat_0=0 +lon_0=9 +k=1 +x_0=3500000 +y_0=0 +ellps=bessel +datum=potsdam +units=m +no_defs + 3500000.00 5651505.56 + +Example using Gauss Boaga on Italy area (EPSG:3004) :: + + $ echo 15 42 | proj +proj=tmerc +lat_0=0 +lon_0=15 +k=0.9996 +x_0=2520000 +y_0=0 +ellps=intl +units=m +no_defs + 2520000.00 4649858.60 + +Mathematical definition +####################### + +The formulas describing the Transverse Mercator are all taken from Evenden's [Evenden2005]_. + +:math:`\phi_0` is the latitude of origin that match the center of the map. It can be set with ``+lat_0``. + +:math:`k_0` is the scale factor at the natural origin (on the central meridian). It can be set with ``+k_0``. + +:math:`M(\phi)` is the meridional distance. + +Spherical form +************** + +Forward projection +================== + +.. math:: + + B = \cos \phi \sin \lambda + +.. math:: + + x = \frac{k_0}{2} \ln(\frac{1+B}{1-B}) + +.. math:: + + y = k_0 ( \arctan(\frac{\tan(\phi)}{\cos \lambda}) - \phi_0) + + +Inverse projection +================== + +.. math:: + + D = \frac{y}{k_0} + \phi_0 + +.. math:: + + x' = \frac{x}{k_0} + +.. math:: + + \phi = \arcsin(\frac{\sin D}{\cosh x'}) + +.. math:: + + \lambda = \arctan(\frac{\sinh x'}{\cos D}) + + +Elliptical form +*************** + +Forward projection +================== + +.. math:: + + N = \frac{k_0}{(1 - e^2 \sin^2\phi)^{1/2}} + +.. math:: + + R = \frac{k_0(1-e^2)}{(1-e^2 \sin^2\phi)^{3/2}} + +.. math:: + + t = \tan(\phi) + +.. math:: + + \eta = \frac{e^2}{1-e^2}cos^2\phi + +.. math:: + + x &= k_0 \lambda \cos \phi \\ + &+ \frac{k_0 \lambda^3 \cos^3\phi}{3!}(1-t^2+\eta^2) \\ + &+ \frac{k_0 \lambda^5 \cos^5\phi}{5!}(5-18t^2+t^4+14\eta^2-58t^2\eta^2) \\ + &+\frac{k_0 \lambda^7 \cos^7\phi}{7!}(61-479t^2+179t^4-t^6) + +.. math:: + + y &= M(\phi) \\ + &+ \frac{k_0 \lambda^2 \sin(\phi) \cos \phi}{2!} \\ + &+ \frac{k_0 \lambda^4 \sin(\phi) \cos^3\phi}{4!}(5-t^2+9\eta^2+4\eta^4) \\ + &+ \frac{k_0 \lambda^6 \sin(\phi) \cos^5\phi}{6!}(61-58t^2+t^4+270\eta^2-330t^2\eta^2) \\ + &+ \frac{k_0 \lambda^8 \sin(\phi) \cos^7\phi}{8!}(1385-3111t^2+543t^4-t^6) + +Inverse projection +================== + +.. math:: + + \phi_1 = M^-1(y) + +.. math:: + + N_1 = \frac{k_0}{1 - e^2 \sin^2\phi_1)^{1/2}} + +.. math:: + + R_1 = \frac{k_0(1-e^2)}{(1-e^2 \sin^2\phi_1)^{3/2}} + +.. math:: + + t_1 = \tan(\phi_1) + +.. math:: + + \eta_1 = \frac{e^2}{1-e^2}cos^2\phi_1 + +.. math:: + + \phi &= \phi_1 \\ + &- \frac{t_1 x^2}{2! R_1 N_1} \\ + &+ \frac{t_1 x^4}{4! R_1 N_1^3}(5+3t_1^2+\eta_1^2-4\eta_1^4-9\eta_1^2t_1^2) \\ + &- \frac{t_1 x^6}{6! R_1 N_1^5}(61+90t_1^2+46\eta_1^2+45t_1^4-252t_1^2\eta_1^2) \\ + &+ \frac{t_1 x^8}{8! R_1 N_1^7}(1385+3633t_1^2+4095t_1^4+1575t_1^6) + +.. math:: + + \lambda &= \frac{x}{\cos \phi N_1} \\ + &- \frac{x^3}{3! \cos \phi N_1^3}(1+2t_1^2+\eta_1^2) \\ + &+ \frac{x^5}{5! \cos \phi N_1^5}(5+6\eta_1^2+28t_1^2-3\eta_1^2+8t_1^2\eta_1^2) \\ + &- \frac{x^7}{7! \cos \phi N_1^7}(61+662t_1^2+1320t_1^4+720t_1^6) + +Further reading +############### + +#. `Wikipedia `_ +#. `EPSG, POSC literature pertaining to Coordinate Conversions and Transformations including Formulas `_ diff --git a/docs/source/operations/projections/tpeqd.rst b/docs/source/operations/projections/tpeqd.rst new file mode 100644 index 00000000..e6d7ef29 --- /dev/null +++ b/docs/source/operations/projections/tpeqd.rst @@ -0,0 +1,10 @@ +.. _tpeqd: + +******************************************************************************** +Two Point Equidistant +******************************************************************************** + +.. image:: ./images/tpeqd.png + :scale: 50% + :alt: Two Point Equidistant + diff --git a/docs/source/operations/projections/tpers.rst b/docs/source/operations/projections/tpers.rst new file mode 100644 index 00000000..345a5faa --- /dev/null +++ b/docs/source/operations/projections/tpers.rst @@ -0,0 +1,39 @@ +.. _tpers: + +******************************************************************************** +Tilted perspective +******************************************************************************** ++---------------------+----------------------------------------------------------+ +| **Classification** | Azimuthal | ++---------------------+----------------------------------------------------------+ +| **Available forms** | Forward and inverse, spherical projection | ++---------------------+----------------------------------------------------------+ +| **Defined area** | Global | ++---------------------+----------------------------------------------------------+ +| **Implemented by** | Gerald I. Evenden | ++---------------------+----------------------------------------------------------+ +| **Options** | ++---------------------+----------------------------------------------------------+ +| `+h` | Height (in meters) above the surface. Required. | ++---------------------+----------------------------------------------------------+ +| `+azi` | Bearing (in degrees) from due north. | ++---------------------+----------------------------------------------------------+ +| `+tilt` | Angle (in degrees) away from nadir. | ++---------------------+----------------------------------------------------------+ +| `+lat_0` | Latitude (in degrees) of the view position. | ++---------------------+----------------------------------------------------------+ +| `+lon_0` | Longitude (in degrees) of the view position. | ++---------------------+----------------------------------------------------------+ + + +.. image:: ./images/tpers.png + :scale: 50% + :alt: Tilted perspective + + +Tilted Perspective is similar to :ref:`nsper` (``nsper``) in that it simulates a +perspective view from a hight. Where ``nsper`` projects onto a plane tangent to +the surface, Tilted Perspective orients the plane towards the direction of the +view. Thus, extra parameters azi and tilt are required beyond `nsper``'s ``h``. +As with ``nsper``, ``lat_0`` & ``lon_0`` are also required +for satellite position. diff --git a/docs/source/operations/projections/ups.rst b/docs/source/operations/projections/ups.rst new file mode 100644 index 00000000..7a9ab50b --- /dev/null +++ b/docs/source/operations/projections/ups.rst @@ -0,0 +1,10 @@ +.. _ups: + +******************************************************************************** +Universal Polar Stereographic +******************************************************************************** + +.. image:: ./images/ups.png + :scale: 50% + :alt: Universal Polar Stereographic + diff --git a/docs/source/operations/projections/urm5.rst b/docs/source/operations/projections/urm5.rst new file mode 100644 index 00000000..91d06308 --- /dev/null +++ b/docs/source/operations/projections/urm5.rst @@ -0,0 +1,10 @@ +.. _urm5: + +******************************************************************************** +Urmaev V +******************************************************************************** + +.. image:: ./images/urm5.png + :scale: 50% + :alt: Urmaev V + diff --git a/docs/source/operations/projections/urmfps.rst b/docs/source/operations/projections/urmfps.rst new file mode 100644 index 00000000..515ced84 --- /dev/null +++ b/docs/source/operations/projections/urmfps.rst @@ -0,0 +1,10 @@ +.. _urmfps: + +******************************************************************************** +Urmaev Flat-Polar Sinusoidal +******************************************************************************** + +.. image:: ./images/urmfps.png + :scale: 50% + :alt: Urmaev Flat-Polar Sinusoidal + diff --git a/docs/source/operations/projections/utm.rst b/docs/source/operations/projections/utm.rst new file mode 100644 index 00000000..7fb66cb8 --- /dev/null +++ b/docs/source/operations/projections/utm.rst @@ -0,0 +1,10 @@ +.. _utm: + +******************************************************************************** +Universal Transverse Mercator (UTM) +******************************************************************************** + +.. image:: ./images/utm.png + :scale: 50% + :alt: Universal Transverse Mercator (UTM) + diff --git a/docs/source/operations/projections/vandg.rst b/docs/source/operations/projections/vandg.rst new file mode 100644 index 00000000..cdc772bb --- /dev/null +++ b/docs/source/operations/projections/vandg.rst @@ -0,0 +1,10 @@ +.. _vandg: + +******************************************************************************** +van der Grinten (I) +******************************************************************************** + +.. image:: ./images/vandg.png + :scale: 50% + :alt: van der Grinten (I) + diff --git a/docs/source/operations/projections/vandg2.rst b/docs/source/operations/projections/vandg2.rst new file mode 100644 index 00000000..556929e2 --- /dev/null +++ b/docs/source/operations/projections/vandg2.rst @@ -0,0 +1,10 @@ +.. _vandg2: + +******************************************************************************** +van der Grinten II +******************************************************************************** + +.. image:: ./images/vandg2.png + :scale: 50% + :alt: van der Grinten II + diff --git a/docs/source/operations/projections/vandg3.rst b/docs/source/operations/projections/vandg3.rst new file mode 100644 index 00000000..d767c4d5 --- /dev/null +++ b/docs/source/operations/projections/vandg3.rst @@ -0,0 +1,10 @@ +.. _vandg3: + +******************************************************************************** +van der Grinten III +******************************************************************************** + +.. image:: ./images/vandg3.png + :scale: 50% + :alt: van der Grinten III + diff --git a/docs/source/operations/projections/vandg4.rst b/docs/source/operations/projections/vandg4.rst new file mode 100644 index 00000000..097ba1d8 --- /dev/null +++ b/docs/source/operations/projections/vandg4.rst @@ -0,0 +1,10 @@ +.. _vandg4: + +******************************************************************************** +van der Grinten IV +******************************************************************************** + +.. image:: ./images/vandg4.png + :scale: 50% + :alt: van der Grinten IV + diff --git a/docs/source/operations/projections/vitk1.rst b/docs/source/operations/projections/vitk1.rst new file mode 100644 index 00000000..b9081547 --- /dev/null +++ b/docs/source/operations/projections/vitk1.rst @@ -0,0 +1,10 @@ +.. _vitk1: + +******************************************************************************** +Vitkovsky I +******************************************************************************** + +.. image:: ./images/vitk1.png + :scale: 50% + :alt: Vitkovsky I + diff --git a/docs/source/operations/projections/wag1.rst b/docs/source/operations/projections/wag1.rst new file mode 100644 index 00000000..dd1ed39e --- /dev/null +++ b/docs/source/operations/projections/wag1.rst @@ -0,0 +1,10 @@ +.. _wag1: + +******************************************************************************** +Wagner I (Kavraisky VI) +******************************************************************************** + +.. image:: ./images/wag1.png + :scale: 50% + :alt: Wagner I (Kavraisky VI) + diff --git a/docs/source/operations/projections/wag2.rst b/docs/source/operations/projections/wag2.rst new file mode 100644 index 00000000..9c7b0edc --- /dev/null +++ b/docs/source/operations/projections/wag2.rst @@ -0,0 +1,18 @@ +.. _wag2: + +******************************************************************************** +Wagner II +******************************************************************************** + +.. image:: ./images/wag2.png + :scale: 50% + :alt: Wagner II + + +.. math:: + + x &= 0.92483 \lambda \cos \theta + + y &= 1.38725\theta + + \sin \theta &= 0.88022 \sin(0.8855\phi) diff --git a/docs/source/operations/projections/wag3.rst b/docs/source/operations/projections/wag3.rst new file mode 100644 index 00000000..fb70a0a6 --- /dev/null +++ b/docs/source/operations/projections/wag3.rst @@ -0,0 +1,16 @@ +.. _wag3: + +******************************************************************************** +Wagner III +******************************************************************************** + +.. image:: ./images/wag3.png + :scale: 50% + :alt: Wagner III + + +.. math:: + + x &= [\cos\phi_{ts} / \cos ( 2\phi_{ts} / 3)] \lambda \cos (2\phi /3) + + y = \phi diff --git a/docs/source/operations/projections/wag4.rst b/docs/source/operations/projections/wag4.rst new file mode 100644 index 00000000..7b8dac96 --- /dev/null +++ b/docs/source/operations/projections/wag4.rst @@ -0,0 +1,10 @@ +.. _wag4: + +******************************************************************************** +Wagner IV +******************************************************************************** + +.. image:: ./images/wag4.png + :scale: 50% + :alt: Wagner IV + diff --git a/docs/source/operations/projections/wag5.rst b/docs/source/operations/projections/wag5.rst new file mode 100644 index 00000000..f880290b --- /dev/null +++ b/docs/source/operations/projections/wag5.rst @@ -0,0 +1,10 @@ +.. _wag5: + +******************************************************************************** +Wagner V +******************************************************************************** + +.. image:: ./images/wag5.png + :scale: 50% + :alt: Wagner V + diff --git a/docs/source/operations/projections/wag6.rst b/docs/source/operations/projections/wag6.rst new file mode 100644 index 00000000..f74749a5 --- /dev/null +++ b/docs/source/operations/projections/wag6.rst @@ -0,0 +1,10 @@ +.. _wag6: + +******************************************************************************** +Wagner VI +******************************************************************************** + +.. image:: ./images/wag6.png + :scale: 50% + :alt: Wagner VI + diff --git a/docs/source/operations/projections/wag7.rst b/docs/source/operations/projections/wag7.rst new file mode 100644 index 00000000..be1401b8 --- /dev/null +++ b/docs/source/operations/projections/wag7.rst @@ -0,0 +1,10 @@ +.. _wag7: + +******************************************************************************** +Wagner VII +******************************************************************************** + +.. image:: ./images/wag7.png + :scale: 50% + :alt: Wagner VII + diff --git a/docs/source/operations/projections/weren.rst b/docs/source/operations/projections/weren.rst new file mode 100644 index 00000000..de7c5abf --- /dev/null +++ b/docs/source/operations/projections/weren.rst @@ -0,0 +1,10 @@ +.. _weren: + +******************************************************************************** +Werenskiold I +******************************************************************************** + +.. image:: ./images/weren.png + :scale: 50% + :alt: Werenskiold I + diff --git a/docs/source/operations/projections/wink1.rst b/docs/source/operations/projections/wink1.rst new file mode 100644 index 00000000..00346765 --- /dev/null +++ b/docs/source/operations/projections/wink1.rst @@ -0,0 +1,10 @@ +.. _wink1: + +******************************************************************************** +Winkel I +******************************************************************************** + +.. image:: ./images/wink1.png + :scale: 50% + :alt: Winkel I + diff --git a/docs/source/operations/projections/wink2.rst b/docs/source/operations/projections/wink2.rst new file mode 100644 index 00000000..7e9b48a7 --- /dev/null +++ b/docs/source/operations/projections/wink2.rst @@ -0,0 +1,10 @@ +.. _wink2: + +******************************************************************************** +Winkel II +******************************************************************************** + +.. image:: ./images/wink2.png + :scale: 50% + :alt: Winkel II + diff --git a/docs/source/operations/projections/wintri.rst b/docs/source/operations/projections/wintri.rst new file mode 100644 index 00000000..bfd5032f --- /dev/null +++ b/docs/source/operations/projections/wintri.rst @@ -0,0 +1,10 @@ +.. _wintri: + +******************************************************************************** +Winkel Tripel +******************************************************************************** + +.. image:: ./images/wintri.png + :scale: 50% + :alt: Winkel Tripel + diff --git a/docs/source/operations/transformations/deformation.rst b/docs/source/operations/transformations/deformation.rst new file mode 100644 index 00000000..2489f18e --- /dev/null +++ b/docs/source/operations/transformations/deformation.rst @@ -0,0 +1,148 @@ +.. _deformation: + +================================================================================ +Kinematic datum shifting utilizing a deformation model +================================================================================ + +Perform datum shifts means of a deformation/velocity model. + ++-----------------+--------------------------------------------------------------------+ +| **Input type** | Cartesian coordinates. | ++-----------------+--------------------------------------------------------------------+ +| **Output type** | Cartesian coordinates. | ++-----------------+--------------------------------------------------------------------+ +| **Options** | ++-----------------+--------------------------------------------------------------------+ +| `xy_grids` | Comma-separated list of grids to load. | ++-----------------+--------------------------------------------------------------------+ +| `z_grids` | Comma-separated list of grids to load. | ++-----------------+--------------------------------------------------------------------+ +| `t_epoch` | Central epoch of transformation. [decimalyear]. Only used in | +| | spatiotemporal transformations. | ++-----------------+--------------------------------------------------------------------+ +| `t_obs` | Observation time of coordinate(s). Mostly useful in 2D and 3D | +| | transformations. [decimalyear]. *Optional*. | ++-----------------+--------------------------------------------------------------------+ + +The deformation operation is used to adjust coordinates for intraplate deformations. +Usually the transformation parameters for regional plate-fixed reference frames such as +the ETRS89 does not take intraplate deformation into account. It is assumed that +tectonic plate of the region is rigid. Often times this is true, but near the plate +boundary and in areas with post-glacial uplift the assumption breaks. Tntraplate +deformations can be modelled and then applied to the coordinates so that +they represent the physical world better. In PROJ this is done with the deformation +operation. + +The horizontal grid is stored in CTable2 format and the vertical grid is stored in the +GTX format. Both grids are expected to contain grid-values in units of mm/year. +Details about the formats can be found in the GDAL documentation. GDAL both reads and +writes both file formats. Using GDAL for construction of new grids is recommended. + +Example +------------------------------------------------------------------------------- + +In [Häkli2016]_ coordinate transformation including a deformation model is described. +The paper describes how coordinates from the global ITRFxx frames are transformed to the +local Nordic realisations of ERTS89. Scandinavia is an area with significant post-glacial +rebound. The deformations from the post-glacial uplift is not accounted for in the +offcial ETRS89 transformations so in order to get accurate transformations in the Nordic +countries it is necesarry to apply the deformation model. The transformation from ITRF2008 +to the Danish realisation of ETRS89 is in PROJ described as:: + + proj = pipeline ellps = GRS80 + # ITRF2008@t_obs -> ITRF2000@t_obs + step init = ITRF2008:ITRF2000 + # ITRF2000@t_obs -> ETRF2000@t_obs + step proj=helmert t_epoch = 2000.0 transpose + x = 0.054 rx = 0.000891 drx = 8.1e-05 + y = 0.051 ry = 0.00539 dry = 0.00049 + z = -0.048 rz = -0.008712 drz = -0.000792 + # ETRF2000@t_obs -> NKG_ETRF00@2000.0 + step proj = deformation t_epoch = 2000.0 + xy_grids = ./nkgrf03vel_realigned_xy.ct2 + z_grids = ./nkgrf03vel_realigned_z.gtx + # NKG_ETRF@2000.0 -> ETRF92@2000.0 + step proj=helmert transpose s = -0.009420e + x = 0.03863 rx = 0.00617753 + y = 0.147 ry = 5.064e-05 + z = 0.02776 rz = 4.729e-05 + # ETRF92@2000.0 -> ETRF92@1994.704 + step proj = deformation t_epoch = 1994.704 t_obs = 2000.0 + xy_grids = ./nkgrf03vel_realigned_xy.ct2 + z_grids = ./nkgrf03vel_realigned_z.gtx + +From this we can see that the transformation from ITRF2008 to the Danish realisation of +ETRS89 is a combination of Helmert transformations and adjustments with a deformation +model. The first use of the deformation operation is:: + + proj = deformation t_epoch = 2000.0 + xy_grids = ./nkgrf03vel_realigned_xy.ct2 + z_grids = ./nkgrf03vel_realigned_z.gtx + +Here we set the central epoch of the transformation, 2000.0. The observation epoch +is expected as part of the input coordinate tuple. The deformation model is +described by two grids, specified with *xy_grids* and *z_grids*. The first is +the horizontal part of the model and the second is the vertical component. + +Mathematical description +------------------------------------------------------------------------------- + +Mathematically speaking, application of a deformation model is simple. The deformation model is +represented as a grid of velocities in three dimensions. Coordinate corrections are +applied in cartesian space. For a given coordinate, :math:`(X, Y, Z)`, velocities +:math:`(V_X, V_Y, V_Z)` can be interpolated from the gridded model. The time span +between :math:`t_c` and :math:`t_{obs}` determine the magnitude of the coordinate +correcton as seen in eq. :eq:`apply_velocity` below. + +.. math:: + :label: apply_velocity + + \begin{align} + \begin{pmatrix} + X \\ + Y \\ + Z \\ + \end{pmatrix}_B = + \begin{pmatrix} + X \\ + Y \\ + Z \\ + \end{pmatrix}_A + + (t_c - t_{obs}) + \begin{pmatrix} + V_X \\ + V_Y \\ + V_Z \\ + \end{pmatrix} + \end{align} + +Corrections are done in cartesian space. + +Coordinates of the gridded model are in ENU (east, north, up) space because it would +otherwise require an enormous 3 dimensional grid to handle the corrections in cartesian +space. Keeping the correction in lat/long space reduces the complexity of the grid +significantly. Consequentyly though, the input coordinates needs to be converted to +lat/long space when searching for corrections in the grid. This is done with *cart* +operation. The converted grid corrections can then be applied to the input coordinates +in cartesian space. The conversion from ENU space to cartesian space is done in the +following way: + +.. math:: + :label: enu2xyz + + \begin{align} + \begin{pmatrix} + X \\ + Y \\ + Z \\ + \end{pmatrix} = + \begin{pmatrix} + -\sin\phi \cos\lambda N - \sin\lambda E + \cos\phi \cos\lambda U \\ + -\sin\phi \sin\lambda N + \sin\lambda E + \cos\phi \sin\lambda U \\ + \cos\phi N + \sin\phi U \\ + \end{pmatrix} + \end{align} + +where :math:`\phi` and :math:`\lambda` are the latitude and longitude of the coordinate +that is searched for in the grid. :math:`(E, N, U)` are the grid values in ENU-space and +:math:`(X, Y, Z)` are the corrections converted to cartesian space. diff --git a/docs/source/operations/transformations/helmert.rst b/docs/source/operations/transformations/helmert.rst new file mode 100644 index 00000000..03e5db15 --- /dev/null +++ b/docs/source/operations/transformations/helmert.rst @@ -0,0 +1,388 @@ +.. _helmert: + +================================================================================ +Helmert transform +================================================================================ + +The Helmert transformation changes coordinates from one reference frame to +anoether by means of 3-, 4-and 7-parameter shifts, or one of their 6-, 8- and +14-parameter kinematic counterparts. + ++-----------------+-------------------------------------------------------------------+ +| **Input type** | Cartesian coordinates (spatial), decimalyears (temporal). | ++-----------------+-------------------------------------------------------------------+ +| **Output type** | Cartesian coordinates (spatial), decimalyears (temporal). | ++-----------------+-------------------------------------------------------------------+ +| **Options** | ++----------------+--------------------------------------------------------------------+ +| `x` | Translation of the x-axis [m]. *Optional*. | ++----------------+--------------------------------------------------------------------+ +| `y` | Translation of the y-axis [m]. *Optional*. | ++----------------+--------------------------------------------------------------------+ +| `z` | Translation of the z-axis. [m]. *Optional*. | ++----------------+--------------------------------------------------------------------+ +| `s` | Scale factor [ppm]. *Optional*. | ++----------------+--------------------------------------------------------------------+ +| `rx` | X-axis rotation in the 3D Helmert [arc seconds]. *Optional*. | ++----------------+--------------------------------------------------------------------+ +| `ry` | Y-axis rotatoin in the 3D Helmert [arc seconds]. *Optional*. | ++----------------+--------------------------------------------------------------------+ +| `rz` | Z-axis rotation in the 3D Helmert [arc seconds]. *Optional*. | ++----------------+--------------------------------------------------------------------+ +| `theta` | Rotation angle in the 2D Helmert. [arc seconds]. *Optional*. | ++----------------+--------------------------------------------------------------------+ +| `dx` | Translation rate of the x-axis. [m/year]. *Optional*. | ++----------------+--------------------------------------------------------------------+ +| `dy` | Translation rate of the y-axis. [m/year]. *Optional*. | ++----------------+--------------------------------------------------------------------+ +| `dz` | Translation rate of the z-axis. [m/year]. *Optional*. | ++----------------+--------------------------------------------------------------------+ +| `ds` | Scale rate factor [ppm/year]. *Optional*. | ++----------------+--------------------------------------------------------------------+ +| `drx` | Rotation rate of the x-axis [arc seconds/year]. *Optional*. | ++----------------+--------------------------------------------------------------------+ +| `dry` | Rotation rate of the y-axis [arc seconds/year]. *Optional*. | ++----------------+--------------------------------------------------------------------+ +| `drz` | Rotation rate of the y-axis [arc seconds/year]. *Optional*. | ++----------------+--------------------------------------------------------------------+ +| `t_epoch` | Central epoch of transformation. [decimalyear]. Only used in | +| | spatiotemporal transformations. *Optional*. | ++----------------+--------------------------------------------------------------------+ +| `t_obs` | Observation time of coordinate(s). Mostly useful in 2D and 3D | +| | transformations. [decimalyear]. *Optional*. | ++----------------+--------------------------------------------------------------------+ +| `exact` | Use exact transformation equations. *Optional*. | ++----------------+--------------------------------------------------------------------+ +| `transpose` | Transpose rotation matrix. *Optional*. | ++----------------+--------------------------------------------------------------------+ + +The Helmert transform, in all it's various incarnations, is used to perform reference +frame shifts. The transformation operates in cartesian space. It can be used to transform +planar coordinates from one datum to another, transform 3D cartesian +coordinates from one static reference frame to another or it can be used to do fully +kinematic transformations from global reference frames to local static frames. + +All of the parameters described in the table above are marked as optional. This is true +as long as at least one parameter is defined in the setup of the transformation. +The behaviour of the transformation depends on which parameters are used in the setup. +For instance, if a rate of change paramater is specified a kinematic version of the +transformation is used. + +The kinematic transformations require an observation time of the coordinate, as well +as a central epoch for the transformation. The latter is usually documented +alongside the rest of the transformation parameters for a given transformation. +The central eopch is controlled with the parameter `t_epoch`. The observation +time can either by stated as part of the coordinate when using PROJ's +4D-functionality or it can be controlled in the transformation setup by the +parameter `t_obs`. When `t_obs` is specified, all transformed coordinates are +treated as if they have the same observation time. + +Examples ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +Transforming coordinates from NAD72 to NAD83 using the 4 parameter 2D Helmert: + +:: + + proj=helmert ellps=GRS80 x=-9597.3572 y=.6112 + s=0.304794780637 theta=-1.244048 + +Simplified transformations from ITRF2008/IGS08 to ETRS89 using 7 parameters: + +:: + + proj=helmert ellps=GRS80 x=0.67678 y=0.65495 z=-0.52827 + rx=-0.022742 ry=0.012667 rz=0.022704 s=-0.01070 + +Transformation from `ITRF2000@2017.0` to `ITRF93@2017.0` using 15 parameters: + +:: + + proj=helmert ellps=GRS80 + x=0.0127 y=0.0065 z=-0.0209 s=0.00195 + dx=-0.0029 dy=-0.0002 dz=-0.0006 ds=0.00001 + rx=-0.00039 ry=0.00080 rz=-0.00114 + drx=-0.00011 dry=-0.00019 drz=0.00007 + epoch=1988.0 tobs=2017.0 transpose + +Mathematical description ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +In the notation used below, :math:`\hat{P}` is the rate of change of a given transformation +parameter :math:`P`. :math:`\dot{P}` is the kinematically adjusted version of :math:`P`, +described by + +.. math:: + :label: propagation + + \dot{P}= P + \hat{P}\left(t - t_{central}\right) + +where :math:`t` is the observation time of the coordinate and :math:`t_{central}` is +the central epoch of the transformation. Equation :eq:`propagation` can be used to +propagate all transformation parameters in time. + +Superscripts of vectors denote the reference frame the coordinates in the vector belong to. + + +2D Helmert +------------------------------------------------------------------------------- + +The simplest version of the Helmert transform is the 2D case. In the 2-dimensional +case only the horizontal coordinates are changed. The coordinates can be +translated, rotated and scale. Translation is controlled with the `x` and `y` +parameters. The rotation is determined by `theta` and the scale is controlled with +the `s` paramaters. + +.. note:: + + The scaling parameter `s` is unitless for the 2D Helmert, as opposed to the + 3D version where the scaling parameter is given in units of ppm. + +Mathematically the 2D Helmert is described as: + +.. math:: + :label: 4param + + \begin{align} + \begin{bmatrix} + X \\ + Y \\ + \end{bmatrix}^B = + \begin{bmatrix} + T_x \\ + T_y \\ + \end{bmatrix} + + s + \begin{bmatrix} + \hphantom{-}\cos \theta & \sin \theta \\ + -\sin \theta & \cos \theta \\ + \end{bmatrix} + \begin{bmatrix} + X \\ + Y \\ + \end{bmatrix}^A + \end{align} + + +:eq:`4param` can be extended to a time-varying kinematic version by +adjusting the parameters with :eq:`propagation` to :eq:`4param`, which yields +the kinematic 2D Helmert transform: + +.. math:: + :label: 8param + + \begin{align} + \begin{bmatrix} + X \\ + Y \\ + \end{bmatrix}^B = + \begin{bmatrix} + \dot{T_x} \\ + \dot{T_y} \\ + \end{bmatrix} + + s(t) + \begin{bmatrix} + \hphantom{-}\cos \dot{\theta} & \sin \dot{\theta} \\ + -\sin\ \dot{\theta} & \cos \dot{\theta} \\ + \end{bmatrix} + \begin{bmatrix} + X \\ + Y \\ + \end{bmatrix}^A + \end{align} + +All parameters in :eq:`8param` are determined by the use of :eq:`propagation`, +which applies the rate of change to each individual parameter for a given +timespan between :math:`t` and :math:`t_{central}`. + + +3D Helmert +------------------------------------------------------------------------------- + +The general form of the 3D Helmert is + +.. math:: + :label: general-helmert + + + \begin{align} + V^B = T + \left(1 + s \times 10^{-6}\right) \mathbf{R} V^A + \end{align} + +Where :math:`T` is a vector consisting of the three translation parameters, :math:`s` +is the scaling factor and :math:`\mathbf{R}` is a rotation matrix. :math:`V^A` and +:math:`V^B` are coordinate vectors, with :math:`V^A` being the input coordinate and +:math:`V^B` is the output coordinate. + +The rotation matrix is composed of three rotation matrices, one for each axis: + +.. math:: + + \begin{align} + \mathbf{R}_X &= \begin{bmatrix} 1 & 0 & 0\\ 0 & \cos\phi & -\sin\phi\\ 0 & \sin\phi & \cos\phi \end{bmatrix} + \end{align} + +.. math:: + + \begin{align} + \mathbf{R}_Y &= \begin{bmatrix} \cos\theta & 0 & \sin\theta\\ 0 & 1 & 0\\ -\sin\theta & 0 & \cos\theta \end{bmatrix} + \end{align} + +.. math:: + + \begin{align} + \mathbf{R}_Z &= \begin{bmatrix} \cos\psi & -\sin\psi & 0\\ \sin\psi & \cos\psi & 0\\ 0 & 0 & 1 \end{bmatrix} + \end{align} + +The three rotation matrices can be combined in one: + +.. math:: + + \begin{align} + \mathbf{R} = \mathbf{R_X} \mathbf{R_Y} \mathbf{R_Y} + \end{align} + +For :math:`\mathbf{R}`, this yields: + +.. math:: + :label: rot_exact + + \begin{bmatrix} + \cos\theta \cos\psi & -\cos\phi \sin\psi + \sin\phi \sin\theta \cos\psi & \sin\phi \sin\psi + \cos\phi \sin\theta \cos\psi \\ + \cos\theta\sin\psi & \cos\phi \cos\psi + \sin\phi \sin\theta \sin\psi & - \sin\phi \cos\psi + \cos\phi \sin\theta \sin\psi \\ + -\sin\theta & \sin\phi \cos\theta & \cos\phi \cos\theta \\ + \end{bmatrix} + + +Using the small angle approxition the rotation matrix can be simplified to + +.. math:: + :label: rot_approx + + \begin{align} \mathbf{R} = + \begin{bmatrix} + 1 & -R_z & R_y \\ + Rz & 1 & -R_x \\ + -Ry & R_x & 1 \\ + \end{bmatrix} + \end{align} + +Which allow us to express the most common version of the Helmert transform, +using the approximated rotation matrix: + + +.. math:: + :label: 7param + + \begin{align} + \begin{bmatrix} + X \\ + Y \\ + Z \\ + \end{bmatrix}^B = + \begin{bmatrix} + T_x \\ + T_y \\ + T_z \\ + \end{bmatrix} + + \left(1 + s \times 10^{-6}\right) + \begin{bmatrix} + 1 & -R_z & R_y \\ + Rz & 1 & -R_x \\ + -Ry & R_x & 1 \\ + \end{bmatrix} + \begin{bmatrix} + X \\ + Y \\ + Z \\ + \end{bmatrix}^A + \end{align} + +If the rotation matrix is transposed the transformation is effectively reversed. +This is cause for some confusion since there is no correct way of defining the +rotation matrix. Two conventions exists and they seem to be equally popular. +In PROJ the rotation matrix can be transposed by adding the `transpose` flag in +the transformation setup. + +Applying :eq:`propagation` we get the kinematic version of the approximated +3D Helmert: + +.. math:: + :label: 14param + + \begin{align} + \begin{bmatrix} + X \\ + Y \\ + Z \\ + \end{bmatrix}^B = + \begin{bmatrix} + \dot{T_x} \\ + \dot{T_y} \\ + \dot{T_z} \\ + \end{bmatrix} + + \left(1 + \dot{s} \times 10^{-6}\right) + \begin{bmatrix} + 1 & -\dot{R_z} & \dot{R_y} \\ + \dot{R_z} & 1 & -\dot{R_x} \\ + -\dot{R_y} & \dot{R_x} & 1 \\ + \end{bmatrix} + \begin{bmatrix} + X \\ + Y \\ + Z \\ + \end{bmatrix}^A + \end{align} + + + + +The Helmert transformation can be applied without using the rotation parameters, +in which case it becomes a simlpe translation of the origin of the coordinate +system. When using the Helmert in this version equation :eq:`general-helmert` +simplies to: + +.. math:: + :label: 3param + + \begin{align} + \begin{bmatrix} + X \\ + Y \\ + Z \\ + \end{bmatrix}^B = + \begin{bmatrix} + T_x \\ + T_y \\ + T_z \\ + \end{bmatrix} + + \begin{bmatrix} + X \\ + Y \\ + Z \\ + \end{bmatrix}^A + \end{align} + +That after application of :eq:`propagation` has the following kinematic +countpart: + +.. math:: + :label: 6param + + \begin{align} + \begin{bmatrix} + X \\ + Y \\ + Z \\ + \end{bmatrix}^B = + \begin{bmatrix} + \dot{T_x} \\ + \dot{T_y} \\ + \dot{T_z} \\ + \end{bmatrix} + + \begin{bmatrix} + X \\ + Y \\ + Z \\ + \end{bmatrix}^A + \end{align} diff --git a/docs/source/operations/transformations/hgridshift.rst b/docs/source/operations/transformations/hgridshift.rst new file mode 100644 index 00000000..7f3c9895 --- /dev/null +++ b/docs/source/operations/transformations/hgridshift.rst @@ -0,0 +1,39 @@ +.. _hgridshift: + +================================================================================ +Horizontal grid shift +================================================================================ + +Change of horizontal datum by grid shift. + ++-----------------+--------------------------------------------------------------------+ +| **Input type** | Geodetic coordinates. | ++-----------------+--------------------------------------------------------------------+ +| **Output type** | Geodetic coordinates. | ++-----------------+--------------------------------------------------------------------+ +| **Options** | ++-----------------+--------------------------------------------------------------------+ +| `+grids` | Comma-separated list of grids to load. | ++-----------------+--------------------------------------------------------------------+ + +The horizontal grid shift is done by offsetting the planar input coordinates by +a specific amount determined by the loaded grids. The simplest use case of the +horizontal grid shift is applying a single grid:: + + +hgridshift +grids=nzgr2kgrid0005.gsb + + +More than one grid can be loaded at the same time, for instance in case the +dataset needs to be transformed spans several countries. In this example grids +of the continental US, Alaska and Canada is loaded at the same time:: + + +hgridshift +grids=@conus,@alaska,@ntv2_0.gsb,@ntv_can.dat + +The ``@`` in the above example states that the grid is optional, in case the grid +is not found in the PROJ search path. The list of grids is prioritized so that +grids in the start of the list takes presedence over the grids in the back of the +list. + +PROJ supports CTable2, NTv1 and NTv2 files for horizontal grid corrections. Details +about all three formats can be found in the GDAL documentation. GDAL reads and +writes all three formats. Using GDAL for construction of new grids is recommended. diff --git a/docs/source/operations/transformations/index.rst b/docs/source/operations/transformations/index.rst new file mode 100644 index 00000000..5112ffa2 --- /dev/null +++ b/docs/source/operations/transformations/index.rst @@ -0,0 +1,17 @@ +.. _transformation_list: + +================================================================================ +Transformations +================================================================================ + +Transformations coordinate operation in which the two coordinate reference +systems are based on different datums. + +.. toctree:: + :maxdepth: 1 + + deformation + helmert + molodensky + hgridshift + vgridshift diff --git a/docs/source/operations/transformations/molodensky.rst b/docs/source/operations/transformations/molodensky.rst new file mode 100644 index 00000000..d4ff3e79 --- /dev/null +++ b/docs/source/operations/transformations/molodensky.rst @@ -0,0 +1,74 @@ +.. _molodensky: + +================================================================================ +Molodensky transform +================================================================================ + +The Molodensky transformation resembles a :ref:`Helmert` with zero +rotations and a scale of unity, but converts directly from geodetic coordinates to +geodetic coordinates, without the intermediate shifts to and from cartesian +geocentric coordinates, associated with the Helmert transformation. +The Molodensky transformation is simple to implement and to parameterize, requiring +only the 3 shifts between the input and output frame, and the corresponding +differences between the semimajor axes and flattening parameters of the reference +ellipsoids. Due to its algorithmic simplicity, it was popular prior to the +ubiquity of digital computers. Today, it is mostly interesting for historical +reasons, but nevertheless indispensable due to the large amount of data that has +already been transformed that way [EversKnudsen2017]_. + ++---------------------+----------------------------------------------------------+ +| **Input type** | Geodetic coordinates. | ++---------------------+----------------------------------------------------------+ +| **Output type** | Geodetic coordinates. | ++---------------------+----------------------------------------------------------+ +| **Options** | ++---------------------+----------------------------------------------------------+ +| `+da` | Difference in semimajor axis of the defining ellipsoids. | ++---------------------+----------------------------------------------------------+ +| `+df` | Difference in flattening of the defining ellipsoids. | ++---------------------+----------------------------------------------------------+ +| `+dx` | Offset of the X-axes of the defining ellipsoids. | ++---------------------+----------------------------------------------------------+ +| `+dy` | Offset of the Y-axes of the defining ellipsoids. | ++---------------------+----------------------------------------------------------+ +| `+dz` | Offset of the Z-axes of the defining ellipsoids. | ++---------------------+----------------------------------------------------------+ +| `+ellps` | Ellipsoid definition of source coordinates. | +| | Any specification can be used (e.g. `+a`, `+rf`, etc). | +|   | If not specified, default ellipsoid is used. | ++---------------------+----------------------------------------------------------+ +| `+abridged` | Use the abridged version of the Molodensky transform. | +| | Optional. | ++---------------------+----------------------------------------------------------+ + +The Molodensky transform can be used to perform a datum shift from coordinate +:math:`(\phi_1, \lambda_1, h_1)` to :math:`(\phi_2, \lambda_2, h_2)` where the two +coordinates are referenced to different ellipsoids. This is based on three +assumptions: + + 1. The cartesian axes, :math:`X, Y, Z`, of the two ellipsoids are parallel. + 2. The offset, :math:`\delta X, \delta Y, \delta Z`, between the two ellipsoid + are known. + 3. The characteristics of the two ellipsoids, expressed as the difference in + semimajor axis (:math:`\delta a`) and flattening (:math:`\delta f`), are known. + +The Molodensky transform is mostly used for transforming between old systems +dating back to the time before computers. The advantage of the Molodensky transform +is that it is fairly simple to compute by hand. The ease of computation come at the +cost of limited accuracy. + +A derivation of the mathematical formulas for the Molodensky transform can be found +in [Deakin2004]_. + + +Examples +############################################################################### + +The abridged Molodensky:: + + proj=molodensky a=6378160 rf=298.25 da=-23 df=-8.120449e-8 dx=-134 dy=-48 dz=149 abridged + +The same transformation using the standard Molodensky:: + + proj=molodensky a=6378160 rf=298.25 da=-23 df=-8.120449e-8 dx=-134 dy=-48 dz=149 + diff --git a/docs/source/operations/transformations/vgridshift.rst b/docs/source/operations/transformations/vgridshift.rst new file mode 100644 index 00000000..e9f78310 --- /dev/null +++ b/docs/source/operations/transformations/vgridshift.rst @@ -0,0 +1,41 @@ +.. _vgridshift: + +================================================================================ +Vertical grid shift +================================================================================ + +Change Vertical datum change by grid shift + ++-----------------+--------------------------------------------------------------------+ +| **Input type** | Geodetic coordinates (horizontal), meters (vertical). | ++-----------------+--------------------------------------------------------------------+ +| **Output type** | Geodetic coordinates (horizontal), meters (vertical). | ++-----------------+--------------------------------------------------------------------+ +| **Options** | ++-----------------+--------------------------------------------------------------------+ +| `+grids` | Comma-separated list of grids to load. | ++-----------------+--------------------------------------------------------------------+ + +The vertical grid shift is done by offsetting the vertical input coordinates by +a specific amount determined by the loaded grids. The simplest use case of the +horizontal grid shift is applying a single grid. Here we change the vertical +reference from the ellipsoid to the global geoid model, EGM96:: + + +vgridshift +grids=egm96_16.gtx + + +More than one grid can be loaded at the same time, for instance in the case where +a better geoid model than the global is available for a certain area. Here the +gridshift is set up so that the local DVR90 geoid model takes presedence over +the global model:: + + +vgridshift +grids=@dvr90.gtx,egm96_16.gtx + +The ``@`` in the above example states that the grid is optional, in case the grid +is not found in the PROJ search path. The list of grids is prioritized so that +grids in the start of the list takes presedence over the grids in the back of the +list. + +PROJ supports the GTX file format for vertical grid corrections. Details +about all the format can be found in the GDAL documentation. GDAL both reads and +writes the format. Using GDAL for construction of new grids is recommended. diff --git a/docs/source/resource_files.rst b/docs/source/resource_files.rst index 505132cf..f39604a2 100644 --- a/docs/source/resource_files.rst +++ b/docs/source/resource_files.rst @@ -47,6 +47,8 @@ on the content of the packages maintained there. Links to the resource packages can be found in the :ref:`download section `. +.. _transformation_grids: + Transformation grids ------------------------------------------------------------------------------- @@ -446,8 +448,8 @@ used, then all parameters in that section applies for all proj-strings. Otherwis the identifier is connected to a specific projection. With the defaults file supplied with PROJ the default ellipsoid is set to WGS84 (for all proj-strings). Apart from that only the Albers Equal Area, -:doc:`Lambert Conic Conformal` and the -:doc:`Lagrange` projections have default parameters. +:doc:`Lambert Conic Conformal` and the +:doc:`Lagrange` projections have default parameters. Defaults can be ignored by adding the ``+no_def`` parameter to a proj-string. diff --git a/docs/source/usage/environmentvars.rst b/docs/source/usage/environmentvars.rst index 0d5d06a8..e1d63543 100644 --- a/docs/source/usage/environmentvars.rst +++ b/docs/source/usage/environmentvars.rst @@ -30,7 +30,7 @@ done by setting the variable with no content:: .. envvar:: PROJ_LIB - The location of PROJ :doc:`resource files`. + The location of PROJ :doc:`resource files<../resource_files>`. It is only possible to specify a single library in :envvar:`PROJ_LIB`; e.g. it does not behave like PATH. PROJ is hardcoded to look for resource files in other locations as well, amongst those are the users home directory, diff --git a/docs/source/usage/index.rst b/docs/source/usage/index.rst index c581fd03..163aa374 100644 --- a/docs/source/usage/index.rst +++ b/docs/source/usage/index.rst @@ -17,5 +17,4 @@ command line applications or the C API that is a part of the software package. projections transformation environmentvars - operations/index diff --git a/docs/source/usage/operations/conversions/axisswap.rst b/docs/source/usage/operations/conversions/axisswap.rst deleted file mode 100644 index ddaad075..00000000 --- a/docs/source/usage/operations/conversions/axisswap.rst +++ /dev/null @@ -1,39 +0,0 @@ -.. _axisswap: - -================================================================================ -Axis swap -================================================================================ - -Change the order and sign of 2,3 or 4 axes. - -+--------------+---------------------------------------------------------------+ -| **Options** | -+--------------+---------------------------------------------------------------+ -| `+order` | Ordered comma-separated list of axis, e.g. `+order=2,1,3,4` | -+--------------+---------------------------------------------------------------+ - - -Each of the possible four axes are numbered with 1-4, such that the first input axis -is 1, the second is 2 and so on. The output ordering is controlled by a list of the -input axes re-ordered to the new mapping. - -Examples -################################################################################ - -Reversing the order of the axes:: - - +proj=axisswap +order=4,3,2,1 - -Swapping the first two axes (x and y):: - - +proj=axisswap +order=2,1,3,4 - -The direction, or sign, of an axis can be changed by adding a minus in -front of the axis-number:: - - +proj=axisswap +order=1,-2,3,4 - -It is only necessary to specify the axes that are affected by the swap -operation:: - - +proj=axisswap +order=2,1 diff --git a/docs/source/usage/operations/conversions/cart.rst b/docs/source/usage/operations/conversions/cart.rst deleted file mode 100644 index 0c3c7c23..00000000 --- a/docs/source/usage/operations/conversions/cart.rst +++ /dev/null @@ -1,24 +0,0 @@ -.. _cart: - -================================================================================ -Cartesian to geodetic conversion -================================================================================ - -Convert geodetic coordinates to cartesian coordinates. - -+--------------+--------------------------------------------------------------------+ -| **Options** | -+--------------+--------------------------------------------------------------------+ -| `+ellps` | Ellipsoid of the input coordinates. If used together with the | -| |  ellipsoid parameters below, ``+ellps`` is overwritten. | -+--------------+--------------------------------------------------------------------+ -| `+a` | Semi-major radius of ellipsoid axis. | -+--------------+--------------------------------------------------------------------+ -| `+b` | Semi-minor radius of ellipsoid axis. | -+--------------+--------------------------------------------------------------------+ -| `+es` | Eccentricity of ellipsoid. | -+--------------+--------------------------------------------------------------------+ -| `+f` | Flattening of ellipsoid. | -+--------------+--------------------------------------------------------------------+ - - diff --git a/docs/source/usage/operations/conversions/index.rst b/docs/source/usage/operations/conversions/index.rst deleted file mode 100644 index af27e2fd..00000000 --- a/docs/source/usage/operations/conversions/index.rst +++ /dev/null @@ -1,18 +0,0 @@ -.. _conversions_list: - -================================================================================ -Conversions -================================================================================ - -Conversions are coordinate operations in which both coordinate reference systems -are based on the same datum. In PROJ projections are differentiated from -conversions. - -.. toctree:: - :maxdepth: 1 - - axisswap - cart - lonlat - latlon - unitconvert diff --git a/docs/source/usage/operations/conversions/latlon.rst b/docs/source/usage/operations/conversions/latlon.rst deleted file mode 100644 index 6712fa7b..00000000 --- a/docs/source/usage/operations/conversions/latlon.rst +++ /dev/null @@ -1,6 +0,0 @@ -.. _latlon: - -******************************************************************************** -Lat/long (Geodetic alias) -******************************************************************************** - diff --git a/docs/source/usage/operations/conversions/lonlat.rst b/docs/source/usage/operations/conversions/lonlat.rst deleted file mode 100644 index 589cc813..00000000 --- a/docs/source/usage/operations/conversions/lonlat.rst +++ /dev/null @@ -1,6 +0,0 @@ -.. _lonlat: - -******************************************************************************** -Lat/long (Geodetic) -******************************************************************************** - diff --git a/docs/source/usage/operations/conversions/unitconvert.rst b/docs/source/usage/operations/conversions/unitconvert.rst deleted file mode 100644 index 73e517bd..00000000 --- a/docs/source/usage/operations/conversions/unitconvert.rst +++ /dev/null @@ -1,112 +0,0 @@ -.. _unitconvert: - -================================================================================ -Unit conversion -================================================================================ - -Convert between various distance and time units. - -+--------------+--------------------------------------------------------------------+ -| **Options** | -+--------------+--------------------------------------------------------------------+ -| `+xy_in` | Input unit of the horizontal components. | -+--------------+--------------------------------------------------------------------+ -| `+xy_out` | Output unit of the horizontal components. | -+--------------+--------------------------------------------------------------------+ -| `+z_in` | Input unit of the vertical component. | -+--------------+--------------------------------------------------------------------+ -| `+z_out` | Output unit of the vertical component. | -+--------------+--------------------------------------------------------------------+ -| `+t_in` | Input unit of the time component. | -+--------------+--------------------------------------------------------------------+ -| `+t_out` | Output unit of the time component. | -+--------------+--------------------------------------------------------------------+ - -There are many examples of coordinate reference systems that are expressed in -other units than the meter. There are also many cases where temporal data -has to be translated to different units. The `unitconvert` operation takes care -of that. - -Many North American systems are defined with coordinates in feet. For example -in Vermont:: - - +proj=pipeline - +step +proj=tmerc +lat_0=42.5 +lon_0=-72.5 +k=0.999964286 +x_0=500000.00001016 +y_0=0 - +step +proj=unitconvert +xy_in=m +xy_out=us-ft - -Often when working with GNNS data the timestamps are presented in GPS-weeks, -but when the data transformed with the `helmert` operation timestamps are -expected to be in units of decimalyears. This can be fixed with `unitconvert`:: - - +proj=pipeline - +step +proj=unitconvert +t_in=gpsweek +t_out=decimalyear - +step +proj=helmert +epoch=2000.0 +t_obs=2017.5 ... - - -Distance units -############################################################################### - -In the table below all distance units supported by PROJ is listed. -The same list can also be produced on the command line with `proj` or `cs2cs`, -by adding the `-lu` flag when calling the utility. - -+----------+---------------------------------+ -| Label | Name | -+----------+---------------------------------+ -| km | Kilometer | -+----------+---------------------------------+ -| m | Meter | -+----------+---------------------------------+ -| dm | Decimeter | -+----------+---------------------------------+ -| cm | Centimeter | -+----------+---------------------------------+ -| mm | Millimeter | -+----------+---------------------------------+ -| kmi | International Nautical Mile | -+----------+---------------------------------+ -| in | International Inch | -+----------+---------------------------------+ -| ft | International Foot | -+----------+---------------------------------+ -| yd | International Yard | -+----------+---------------------------------+ -| mi | International Statute Mile | -+----------+---------------------------------+ -| fath | International Fathom | -+----------+---------------------------------+ -| ch | International Chain | -+----------+---------------------------------+ -| link | International Link | -+----------+---------------------------------+ -| us-in | U.S. Surveyor's Inch | -+----------+---------------------------------+ -| us-ft | U.S. Surveyor's Foot | -+----------+---------------------------------+ -| us-yd | U.S. Surveyor's Yard | -+----------+---------------------------------+ -| us-ch | U.S. Surveyor's Chain | -+----------+---------------------------------+ -| us-mi | U.S. Surveyor's Statute Mile | -+----------+---------------------------------+ -| ind-yd | Indian Yard | -+----------+---------------------------------+ -| ind-ft | Indian Foot | -+----------+---------------------------------+ -| ind-ch | Indian Chain | -+----------+---------------------------------+ - - -Time units -############################################################################### - -In the table below all time units supported by PROJ is listed. - -+--------------+-----------------------------+ -| mjd | Modfied Julian date | -+--------------+-----------------------------+ -| decimalyear | Decimal year | -+--------------+-----------------------------+ -| gps_week | GPS Week | -+--------------+-----------------------------+ - diff --git a/docs/source/usage/operations/index.rst b/docs/source/usage/operations/index.rst deleted file mode 100644 index 87bfdc40..00000000 --- a/docs/source/usage/operations/index.rst +++ /dev/null @@ -1,22 +0,0 @@ -.. _operations: - -================================================================================ -Coordinate operations -================================================================================ - -Coordinate operations in PROJ are divided into three groups: -Projections, conversions and transformations. -Projections are purely cartographic mappings of the sphere onto the plane. -Technically projections are conversions (according to ISO standards), though in -PROJ projections are distinguished from conversions. Conversions are coordinate -operations that do not exert a change in reference frame. Operations that do -exert a change in reference frame are called transformations. - -.. toctree:: - :maxdepth: 1 - - projections/index - conversions/index - transformations/index - pipeline - diff --git a/docs/source/usage/operations/pipeline.rst b/docs/source/usage/operations/pipeline.rst deleted file mode 100644 index 18637712..00000000 --- a/docs/source/usage/operations/pipeline.rst +++ /dev/null @@ -1,98 +0,0 @@ -.. _pipeline: - -================================================================================ -The pipeline operator -================================================================================ - -Construct complex operations by daisy-chaining operations in a sequential pipeline. - -+-----------------+--------------------------------------------------------------------+ -| **Input type** | Any. | -+-----------------+--------------------------------------------------------------------+ -| **Output type** | Any. | -+-----------------+--------------------------------------------------------------------+ -| **Options** | -+-----------------+--------------------------------------------------------------------+ -| `step` | Separate each step in a pipeline. | -+-----------------+--------------------------------------------------------------------+ -| `inv` | Invert a step in a pipeline. | -+-----------------+--------------------------------------------------------------------+ - -.. note:: See the section on :ref:`transformation` for a more thorough introduction - to the concept of transformation pipelines in PROJ. - - -With the pipeline operation it is possible to perform several operations after each -other on the same input data. This feature makes it possible to create transformations -that are made up of more than one operation, e.g. performing a datum shift and then -applying a suitable map projection. Theoretically any transformation between two -coordinate reference systems is possible to perform using the pipeline operation, -provided that the necessary coordinate operations in each step is available in PROJ. - -A pipeline is made up of a number of steps, with each step being a coordinate operation -in itself. By connecting these individual steps sequentially we end up with a concatenated -coordinate operation. An example of this is a transformation from geodetic coordinates -on the GRS80 ellipsoid to a projected system where the east-west and north-east axes has -been swapped: - -:: - - +proj=pipeline +ellps=GRS80 +step +proj=merc +step +proj=axisswap +order=2,1 - -Here the first step is applying the :ref:`merc` projection and the second step is -applying the :ref:`axisswap` conversion. Note that the `+ellps=GRS80` is specified -before the first occurence of `+step`. This means that the GRS80 ellipsoid is used -in both steps, since any parameter stated before the first occurence of `+step` is -treated as a global parameter and is transferred to each individual steps. - - -Rules for pipelines -------------------------------------------------------------------------------- - -**1. Pipelines must consist of at least one step.** - -:: - - +proj=pipeline - -Will result in an error. - -**2. Pipelines can only be nested if the nested pipeline is defined in an init-file.** - -:: - - +proj=pipeline - +step +proj=pipeline +step +proj=merc +step +proj=axisswap +order=2,1 - +step +proj=unitconvert +xy_in=m +xy_out=us-ft - -Results in an error, while - -:: - - +proj=pipeline - +step +init=predefined_pipelines:projectandswap - +step +proj=unitconvert +xy_in=m +xy_out=us-ft - -does not. - -**3. Pipelines without a forward path can't be constructed.** - -:: - - +proj=pipeline +step +inv +proj=urm5 - -Will result in an error since :ref:`urm5` does not have an inverse operation defined. - -**4. Parameters added before the first `+step` are global and will be applied to all steps.** - -In the following the GRS80 ellipsoid will be applied to all steps. - -:: - - +proj=pipeline +ellps=GRS80 - +step +proj=cart - +step +proj=helmert +x=10 +y=3 +z=1 - +step +proj=cart +inv - +step +proj=merc - - diff --git a/docs/source/usage/operations/projections/aeqd.rst b/docs/source/usage/operations/projections/aeqd.rst deleted file mode 100644 index 32165e49..00000000 --- a/docs/source/usage/operations/projections/aeqd.rst +++ /dev/null @@ -1,22 +0,0 @@ -.. _aeqd: - -******************************************************************************** -Azimuthal Equidistant -******************************************************************************** -+---------------------+----------------------------------------------------------+ -| **Classification** | Azimuthal | -+---------------------+----------------------------------------------------------+ -| **Available forms** | Forward and inverse, spherical and elliptical projection | -+---------------------+----------------------------------------------------------+ -| **Implemented by** | Gerald I. Evenden | -+---------------------+----------------------------------------------------------+ -| **Options** | -+---------------------+----------------------------------------------------------+ -| `+guam` | Use Guam elliptical formulas. Defaults to false. | -+---------------------+----------------------------------------------------------+ - - -.. image:: ./images/aeqd.png - :scale: 50% - :alt: Azimuthal Equidistant - diff --git a/docs/source/usage/operations/projections/airy.rst b/docs/source/usage/operations/projections/airy.rst deleted file mode 100644 index d2730592..00000000 --- a/docs/source/usage/operations/projections/airy.rst +++ /dev/null @@ -1,26 +0,0 @@ -.. _airy: - -******************************************************************************** -Airy -******************************************************************************** -+---------------------+----------------------------------------------------------+ -| **Classification** | | -+---------------------+----------------------------------------------------------+ -| **Available forms** | Forward spherical projection | -+---------------------+----------------------------------------------------------+ -| **Defined area** | Global | -+---------------------+----------------------------------------------------------+ -| **Implemented by** | Gerald I. Evenden | -+---------------------+----------------------------------------------------------+ -| **Options** | -+---------------------+----------------------------------------------------------+ -| `+lat_b` | | -+---------------------+----------------------------------------------------------+ -| `+no_cut` | Do not cut at hemisphere limit | -+---------------------+----------------------------------------------------------+ - - -.. image:: ./images/airy.png - :scale: 50% - :alt: Airy - diff --git a/docs/source/usage/operations/projections/aitoff.rst b/docs/source/usage/operations/projections/aitoff.rst deleted file mode 100644 index 4d681468..00000000 --- a/docs/source/usage/operations/projections/aitoff.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _aitoff: - -******************************************************************************** -Aitoff -******************************************************************************** - -.. image:: ./images/aitoff.png - :scale: 50% - :alt: Aitoff - diff --git a/docs/source/usage/operations/projections/alsk.rst b/docs/source/usage/operations/projections/alsk.rst deleted file mode 100644 index f7a7a0ef..00000000 --- a/docs/source/usage/operations/projections/alsk.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _alsk: - -******************************************************************************** -Mod. Stererographics of Alaska -******************************************************************************** - -.. image:: ./images/alsk.png - :scale: 50% - :alt: Mod. Stererographics of Alaska - diff --git a/docs/source/usage/operations/projections/apian.rst b/docs/source/usage/operations/projections/apian.rst deleted file mode 100644 index add501ea..00000000 --- a/docs/source/usage/operations/projections/apian.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _apian: - -******************************************************************************** -Apian Globular I -******************************************************************************** - -.. image:: ./images/apian.png - :scale: 50% - :alt: Apian Globular I - diff --git a/docs/source/usage/operations/projections/august.rst b/docs/source/usage/operations/projections/august.rst deleted file mode 100644 index e2ad3516..00000000 --- a/docs/source/usage/operations/projections/august.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _august: - -******************************************************************************** -August Epicycloidal -******************************************************************************** - -.. image:: ./images/august.png - :scale: 50% - :alt: August Epicycloidal - diff --git a/docs/source/usage/operations/projections/bacon.rst b/docs/source/usage/operations/projections/bacon.rst deleted file mode 100644 index a87ea7d8..00000000 --- a/docs/source/usage/operations/projections/bacon.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _bacon: - -******************************************************************************** -Bacon Globular -******************************************************************************** - -.. image:: ./images/bacon.png - :scale: 50% - :alt: Bacon Globular - diff --git a/docs/source/usage/operations/projections/bipc.rst b/docs/source/usage/operations/projections/bipc.rst deleted file mode 100644 index 7045f04a..00000000 --- a/docs/source/usage/operations/projections/bipc.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _bipc: - -******************************************************************************** -Bipolar conic of western hemisphere -******************************************************************************** - -.. image:: ./images/bipc.png - :scale: 50% - :alt: Bipolar conic of western hemisphere - diff --git a/docs/source/usage/operations/projections/boggs.rst b/docs/source/usage/operations/projections/boggs.rst deleted file mode 100644 index 1dd7d19f..00000000 --- a/docs/source/usage/operations/projections/boggs.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _boggs: - -******************************************************************************** -Boggs Eumorphic -******************************************************************************** - -.. image:: ./images/boggs.png - :scale: 50% - :alt: Boggs Eumorphic - diff --git a/docs/source/usage/operations/projections/bonne.rst b/docs/source/usage/operations/projections/bonne.rst deleted file mode 100644 index ef87d7c9..00000000 --- a/docs/source/usage/operations/projections/bonne.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _bonne: - -******************************************************************************** -Bonne (Werner lat_1=90) -******************************************************************************** - -.. image:: ./images/bonne.png - :scale: 50% - :alt: Bonne (Werner lat_1=90) - diff --git a/docs/source/usage/operations/projections/calcofi.rst b/docs/source/usage/operations/projections/calcofi.rst deleted file mode 100644 index 650416c1..00000000 --- a/docs/source/usage/operations/projections/calcofi.rst +++ /dev/null @@ -1,95 +0,0 @@ -.. _calcofi: - -******************************************************************************** -Cal Coop Ocean Fish Invest Lines/Stations -******************************************************************************** - -The CalCOFI pseudo-projection is the line and station coordinate system of the -California Cooperative Oceanic Fisheries Investigations program, known as CalCOFI, for sampling offshore of the west coast of the U.S. and Mexico. - -+---------------------+----------------------------------------------------------+ -| **Classification** | Conformal cylindrical | -+---------------------+----------------------------------------------------------+ -| **Available forms** | Forward and inverse, spherical and elliptical projection | -+---------------------+----------------------------------------------------------+ -| **Defined area** | Only valid for the west coast of USA and Mexico | -+---------------------+----------------------------------------------------------+ -| **Implemented by** | Frank Warmerdam | -+---------------------+----------------------------------------------------------+ -| **Options** | -+---------------------+----------------------------------------------------------+ -| `No special options for this projection` | -+---------------------+----------------------------------------------------------+ - - -.. image:: ../../../../images/calcofi.png - :scale: 50% - :align: center - :alt: Cal Coop Ocean Fish Invest Lines/Stations - -The coordinate system is based on the Mercator projection with units rotated -30 -degrees from the meridian so that they are oriented with the coastline of the Southern California Bight and Baja California. -Lines increase from Northwest to Southeast. -A unit of line is 12 nautical miles. Stations increase from inshore to offshore. -A unit of station is equal to 4 nautical miles. -The rotation point is located at line 80, station 60, or 34.15 degrees N, -121.15 degrees W, and is depicted by the red dot in the figure. -By convention, the ellipsoid of Clarke 1866 is used to calculate CalCOFI coordinates. - -The CalCOFI program is a joint research effort by the U.S. National Oceanic and -Atmospheric Administration, University of California Scripps Oceanographic Institute, and California Department of Fish and Game. -Surveys have been conducted for the CalCOFI program since 1951, creating one of the oldest and most scientifically valuable joint oceanographic and fisheries data sets in the world. -The CalCOFI line and station coordinate system is now used by several other programs including the Investigaciones Mexicanas de la Corriente de California (IMECOCAL) program offshore of Baja California. -The figure depicts some commonly sampled locations from line 40 to line 156.7 and offshore to station 120. Blue numbers indicate line (bottom) or station (left) numbers along the grid. Note that lines spaced at approximate 3-1/3 intervals are commonly sampled, e.g., lines 43.3 and 46.7. - -Usage -############################################################################### - -A typical forward CalCOFI projection would be from lon/lat coordinates on the -Clark 1866 ellipsoid. -For example:: - - proj +proj=calcofi +ellps=clrk66 -E <`_ -#. `The Investigaciones Mexicanas de la Corriente de California `_ - - - - - - - - - - - - - - diff --git a/docs/source/usage/operations/projections/cass.rst b/docs/source/usage/operations/projections/cass.rst deleted file mode 100644 index 4111a2ee..00000000 --- a/docs/source/usage/operations/projections/cass.rst +++ /dev/null @@ -1,145 +0,0 @@ -.. _cass: - -******************************************************************************** -Cassini (Cassini-Soldner) -******************************************************************************** - -Although the Cassini projection has been largely replaced by the Transverse Mercator, it is still in limited use outside the United States and was one of the major topographic mapping projections until the early 20th century. - -+---------------------+-------------------------------------------------------------------------+ -| **Classification** | Transverse and oblique cylindrical | -+---------------------+-------------------------------------------------------------------------+ -| **Available forms** | Forward and inverse, Spherical and Elliptical | -+---------------------+-------------------------------------------------------------------------+ -| **Defined area** | Global, but best used near the central meridian with long, narrow areas | -+---------------------+-------------------------------------------------------------------------+ -| **Implemented by** | Gerald I. Evenden | -+---------------------+-------------------------------------------------------------------------+ -| **Options** | -+---------------------+-------------------------------------------------------------------------+ -| `+lat_0` | Latitude of origin (Default to 0) | -+---------------------+-------------------------------------------------------------------------+ - -.. image:: ./images/cass.png - :scale: 50% - :alt: Cassini - -Usage -##### - -There has been little usage of the spherical version of the Cassini, but the ellipsoidal Cassini-Soldner version was adopted by the Ordnance Survey for the official survey of Great Britain during the second half of the 19th century [Steers1970]_. -Many of these maps were prepared at a scale of 1:2,500. -The Cassini-Soldner was also used for the detailed mapping of many German states during the same period. - - -Example using EPSG 30200 (Trinidad 1903, units in clarke's links):: - - $ echo 0.17453293 -1.08210414 | proj +proj=cass +lat_0=10.44166666666667 +lon_0=-61.33333333333334 +x_0=86501.46392051999 +y_0=65379.0134283 +a=6378293.645208759 +b=6356617.987679838 +to_meter=0.201166195164 +no_defs - 66644.94 82536.22 - -Example using EPSG 3068 (Soldner Berlin):: - - $ echo 13.5 52.4 | proj +proj=cass +lat_0=52.41864827777778 +lon_0=13.62720366666667 +x_0=40000 +y_0=10000 +ellps=bessel +datum=potsdam +units=m +no_defs - 31343.05 7932.76 - - -Mathematical definition -####################### - -The formulas describing the Cassini projection are taken from Snyder's [Snyder1987]_. - -:math:`\phi_0` is the latitude of origin that match the center of the map (default to 0). It can be set with ``+lat_0``. - - -Spherical form -============== - -Forward projection ------------------- - -.. math:: - - x = \arcsin(\cos(\phi) \sin(\lambda)) - -.. math:: - - y = \arctan2(\tan(\phi), \cos(\lambda)) - \phi_0 - -Inverse projection ------------------- - -.. math:: - - \phi = \arcsin(\sin(y+\phi_0) \cos(x)) - -.. math:: - - \lambda = \arctan2(\tan(x), \cos(y+\phi_0)) - -Elliptical form -=============== - -Forward projection ------------------- - -.. math:: - - N = (1 - e^2 \sin^2(\phi))^{-1/2} - -.. math:: - - T = \tan^2(\phi) - -.. math:: - - A = \lambda \cos(\phi) - -.. math:: - - C = \frac{e^2}{1-e^2} cos^2(\phi) - -.. math:: - - x = N ( A - T \frac{A^3}{6} - (8-T+8C)T\frac{A^5}{120}) - -.. math:: - - y = M(\phi) - M(\phi_0) + N \tan(\phi)(\frac{A^2}{2} + (5-T+6C)\frac{A^4}{24}) - -and M() is the meridional distance function. - -Inverse projection ------------------- - -.. math:: - - \phi' = M^{-1}(M(\phi_0)+y) - -if :math:`\phi' = \frac{\pi}{2}` then :math:`\phi=\phi'` and :math:`\lambda=0` - -otherwise evaluate T and N above using :math:`\phi'` and - -.. math:: - - R = (1 - e^2)(1 - e^2 sin^2 \phi')^{-3/2} - -.. math:: - - D = x/N - -.. math:: - - \phi = \phi' - \tan \phi' \frac{N}{R}(\frac{D^2}{2}-(1+3T)\frac{D^4}{24}) - -.. math:: - - \lambda = \frac{(D - T\frac{D^3}{3} + (1+3T)T\frac{D^5}{15})}{\cos \phi'} - -.. _further-reading: - -Further reading -############### - -#. `Wikipedia `_ -#. [Snyder1987]_ -#. `EPSG, POSC literature pertaining to Coordinate Conversions and Transformations including Formulas `_ diff --git a/docs/source/usage/operations/projections/cc.rst b/docs/source/usage/operations/projections/cc.rst deleted file mode 100644 index 5b30e6c6..00000000 --- a/docs/source/usage/operations/projections/cc.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _cc: - -******************************************************************************** -Central Cylindrical -******************************************************************************** - -.. image:: ./images/cc.png - :scale: 50% - :alt: Central Cylindrical - diff --git a/docs/source/usage/operations/projections/ccon.rst b/docs/source/usage/operations/projections/ccon.rst deleted file mode 100644 index 8a858e38..00000000 --- a/docs/source/usage/operations/projections/ccon.rst +++ /dev/null @@ -1,127 +0,0 @@ -.. _ccon: - -******************************************************************************** -Central Conic -******************************************************************************** - -This is central (centrographic) projection on cone tangent at ``lat_0`` latitude, -identical with ``conic()`` projection from ``mapproj`` R package. - -+---------------------+----------------------------------------------------------+ -| **Classification** | Conic | -+---------------------+----------------------------------------------------------+ -| **Available forms** | Forward and inverse, spherical projection | -+---------------------+----------------------------------------------------------+ -| **Defined area** | Global, but best used near the standard parallel | -+---------------------+----------------------------------------------------------+ -| **Implemented by** | Lukasz Komsta | -+---------------------+----------------------------------------------------------+ -| **Options** | -+---------------------+----------------------------------------------------------+ -| `+lat_1` | Latitude of standard parallel. | -+---------------------+----------------------------------------------------------+ - -.. image:: ./images/ccon.png - :scale: 50% - :alt: Central Conic - - -Usage -######## - -This simple projection is rarely used, as it is not equidistant, equal-area, nor -conformal. - -An example of usage (and the main reason to implement this projection in proj4) -is the ATPOL geobotanical grid of Poland, developed in Institute of Botany, -Jagiellonian University, Krakow, Poland in 1970s [Zajac1978]_. The grid was -originally handwritten on paper maps and further copied by hand. The projection -(together with strange Earth radius) was chosen by its creators as the compromise -fit to existing maps during first software development in DOS era. Many years later -it is still de facto standard grid in Polish geobotanical research. - -The ATPOL coordinates can be achieved with with the following parameters: - -:: - - +proj=ccon +lat_1=52 +lat_0=52 +lon_0=19 +axis=esu +a=6390000 +x_0=330000 +y_0=-350000 - -For more information see [Komsta2016]_ and [Verey2017]_. - - -Forward projection -================== - -.. math:: - - r = \cot \phi_0 - \tan (\phi - \phi_0) - -.. math:: - - x = r \sin (\lambda\sin\phi_0) - -.. math:: - - y = \cot \phi_0 - r \cos (\lambda\sin\phi_0) - - -Inverse projection -================== - -.. math:: - - y = \cot \phi_0 - y - -.. math:: - - \phi = \phi_0 - \tan^{-1} ( \sqrt{x^2+y^2} - \cot \phi_0 ) - -.. math:: - - \lambda = \frac{\tan^{-1} \sqrt{x^2+y^2}}{\sin \phi_0} - -Reference values -================== - -For ATPOL to WGS84 test, run the following script: - -:: - - #!/bin/bash - cat << EOF | src/cs2cs -v -f "%E" +proj=ccon +lat_1=52 +lat_0=52 +lon_0=19 +axis=esu +a=6390000 +x_0=330000 +y_0=-350000 +to +proj=longlat +datum=WGS84 +no_defs - 0 0 - 0 700000 - 700000 0 - 700000 700000 - 330000 350000 - EOF - -It should result with - -:: - - 1.384023E+01 5.503040E+01 0.000000E+00 - 1.451445E+01 4.877385E+01 0.000000E+00 - 2.478271E+01 5.500352E+01 0.000000E+00 - 2.402761E+01 4.875048E+01 0.000000E+00 - 1.900000E+01 5.200000E+01 0.000000E+00 - -Analogous script can be run for reverse test: - -:: - - cat << EOF | src/cs2cs -v -f "%E" +proj=longlat +datum=WGS84 +no_defs +to +proj=ccon +lat_1=52 +lat_0=52 +lon_0=19 +axis=esu +a=6390000 +x_0=330000 +y_0=-350000 - 24 55 - 15 49 - 24 49 - 19 52 - EOF - -and it should give the following results: - -:: - - 6.500315E+05 4.106162E+03 0.000000E+00 - 3.707419E+04 6.768262E+05 0.000000E+00 - 6.960534E+05 6.722946E+05 0.000000E+00 - 3.300000E+05 3.500000E+05 0.000000E+00 diff --git a/docs/source/usage/operations/projections/cea.rst b/docs/source/usage/operations/projections/cea.rst deleted file mode 100644 index 20ebc285..00000000 --- a/docs/source/usage/operations/projections/cea.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _cea: - -******************************************************************************** -Equal Area Cylindrical -******************************************************************************** - -.. image:: ./images/cea.png - :scale: 50% - :alt: Equal Area Cylindrical - diff --git a/docs/source/usage/operations/projections/chamb.rst b/docs/source/usage/operations/projections/chamb.rst deleted file mode 100644 index 2ec9bffe..00000000 --- a/docs/source/usage/operations/projections/chamb.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _chamb: - -******************************************************************************** -Chamberlin Trimetric -******************************************************************************** - -.. image:: ./images/chamb.png - :scale: 50% - :alt: Chamberlin Trimetric - diff --git a/docs/source/usage/operations/projections/collg.rst b/docs/source/usage/operations/projections/collg.rst deleted file mode 100644 index aa16182a..00000000 --- a/docs/source/usage/operations/projections/collg.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _collg: - -******************************************************************************** -Collignon -******************************************************************************** - -.. image:: ./images/collg.png - :scale: 50% - :alt: Collignon - diff --git a/docs/source/usage/operations/projections/crast.rst b/docs/source/usage/operations/projections/crast.rst deleted file mode 100644 index 9d17f274..00000000 --- a/docs/source/usage/operations/projections/crast.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _crast: - -******************************************************************************** -Craster Parabolic (Putnins P4) -******************************************************************************** - -.. image:: ./images/crast.png - :scale: 50% - :alt: Craster Parabolic (Putnins P4) - diff --git a/docs/source/usage/operations/projections/denoy.rst b/docs/source/usage/operations/projections/denoy.rst deleted file mode 100644 index a885ab0e..00000000 --- a/docs/source/usage/operations/projections/denoy.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _denoy: - -******************************************************************************** -Denoyer Semi-Elliptical -******************************************************************************** - -.. image:: ./images/denoy.png - :scale: 50% - :alt: Denoyer Semi-Elliptical - diff --git a/docs/source/usage/operations/projections/eck1.rst b/docs/source/usage/operations/projections/eck1.rst deleted file mode 100644 index 841533ec..00000000 --- a/docs/source/usage/operations/projections/eck1.rst +++ /dev/null @@ -1,18 +0,0 @@ -.. _eck1: - -******************************************************************************** -Eckert I -******************************************************************************** - -.. image:: ./images/eck1.png - :scale: 50% - :alt: Eckert I - - -.. math:: - - x &= 2 \sqrt{2/3\pi} \lambda (1- |\phi|/\pi) - - y &= 2 \sqrt{2/3\pi}\phi - - diff --git a/docs/source/usage/operations/projections/eck2.rst b/docs/source/usage/operations/projections/eck2.rst deleted file mode 100644 index b1bd3179..00000000 --- a/docs/source/usage/operations/projections/eck2.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _eck2: - -******************************************************************************** -Eckert II -******************************************************************************** - -.. image:: ./images/eck2.png - :scale: 50% - :alt: Eckert II - diff --git a/docs/source/usage/operations/projections/eck3.rst b/docs/source/usage/operations/projections/eck3.rst deleted file mode 100644 index ecacc32d..00000000 --- a/docs/source/usage/operations/projections/eck3.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _eck3: - -******************************************************************************** -Eckert III -******************************************************************************** - -.. image:: ./images/eck3.png - :scale: 50% - :alt: Eckert III - diff --git a/docs/source/usage/operations/projections/eck4.rst b/docs/source/usage/operations/projections/eck4.rst deleted file mode 100644 index 3fc6a9fd..00000000 --- a/docs/source/usage/operations/projections/eck4.rst +++ /dev/null @@ -1,19 +0,0 @@ -.. _eck4: - -******************************************************************************** -Eckert IV -******************************************************************************** - -.. image:: ./images/eck4.png - :scale: 50% - :alt: Eckert IV - - -.. math:: - - x = \lambda(1+cos\phi) / \sqrt{ 2 + \pi } - -.. math:: - y = 2 \phi / \sqrt { 2 + \pi } - - diff --git a/docs/source/usage/operations/projections/eck5.rst b/docs/source/usage/operations/projections/eck5.rst deleted file mode 100644 index 1442d99d..00000000 --- a/docs/source/usage/operations/projections/eck5.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _eck5: - -******************************************************************************** -Eckert V -******************************************************************************** - -.. image:: ./images/eck5.png - :scale: 50% - :alt: Eckert V - diff --git a/docs/source/usage/operations/projections/eck6.rst b/docs/source/usage/operations/projections/eck6.rst deleted file mode 100644 index caeaefa6..00000000 --- a/docs/source/usage/operations/projections/eck6.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _eck6: - -******************************************************************************** -Eckert VI -******************************************************************************** - -.. image:: ./images/eck6.png - :scale: 50% - :alt: Eckert VI - diff --git a/docs/source/usage/operations/projections/eqc.rst b/docs/source/usage/operations/projections/eqc.rst deleted file mode 100644 index be431977..00000000 --- a/docs/source/usage/operations/projections/eqc.rst +++ /dev/null @@ -1,110 +0,0 @@ -.. _eqc: - -******************************************************************************** -Equidistant Cylindrical (Plate Carrée) -******************************************************************************** - -The simplest of all projections. Standard parallels (0° when omitted) may be specified that determine latitude of true scale (k=h=1). - -+---------------------+----------------------------------------------------------+ -| **Classification** | Conformal cylindrical | -+---------------------+----------------------------------------------------------+ -| **Available forms** | Forward and inverse | -+---------------------+----------------------------------------------------------+ -| **Defined area** | Global, but best used near the equator | -+---------------------+----------------------------------------------------------+ -| **Implemented by** | Gerald I. Evenden | -+---------------------+----------------------------------------------------------+ -| **Options** | -+---------------------+----------------------------------------------------------+ -| `+lat_ts` | Latitude of true scale. Defaults to 0.0 | -+---------------------+----------------------------------------------------------+ -| `+lat_0` | Center of the map : latitude of origin | -+---------------------+----------------------------------------------------------+ - -.. image:: ./images/eqc.png - :scale: 50% - :alt: Equidistant Cylindrical (Plate Carrée) - -Usage -######## - -Because of the distortions introduced by this projection, it has little use in navigation or cadastral mapping and finds its main use in thematic mapping. -In particular, the plate carrée has become a standard for global raster datasets, such as Celestia and NASA World Wind, because of the particularly simple relationship between the position of an image pixel on the map and its corresponding geographic location on Earth. - -The following table gives special cases of the cylindrical equidistant projection. - -+---------------------------------------------------------+--------------------------+ -| Projection Name | (lat ts=) :math:`\phi_0` | -+---------------------------------------------------------+--------------------------+ -| Plain/Plane Chart | 0° | -+---------------------------------------------------------+--------------------------+ -| Simple Cylindrical | 0° | -+---------------------------------------------------------+--------------------------+ -| Plate Carrée | 0° | -+---------------------------------------------------------+--------------------------+ -| Ronald Miller—minimum overall scale distortion | 37°30′ | -+---------------------------------------------------------+--------------------------+ -| E.Grafarend and A.Niermann | 42° | -+---------------------------------------------------------+--------------------------+ -| Ronald Miller—minimum continental scale distortion | 43°30′ | -+---------------------------------------------------------+--------------------------+ -| Gall Isographic | 45° | -+---------------------------------------------------------+--------------------------+ -| Ronald Miller Equirectangular | 50°30′ | -+---------------------------------------------------------+--------------------------+ -| E.Grafarend and A.Niermann minimum linear distortion | 61°7′ | -+---------------------------------------------------------+--------------------------+ - - -Example using EPSG 32662 (WGS84 Plate Carrée):: - - $ echo 2 47 | proj +proj=eqc +lat_ts=0 +lat_0=0 +lon_0=0 +x_0=0 +y_0=0 +ellps=WGS84 +datum=WGS84 +units=m +no_defs - 222638.98 5232016.07 - -Example using Plate Carrée projection with true scale at latitude 30° and central meridian 90°W:: - - $ echo -88 30 | proj +proj=eqc +lat_ts=30 +lat_0=90w - -8483684.61 13358338.90 - - -Mathematical definition -####################### - -The formulas describing the Equidistant Cylindrical projection are all taken from Snyder's [Snyder1987]_. - -:math:`\phi_{ts}` is the latitude of true scale, that mean the standard parallels where the scale of the projection is true. It can be set with ``+lat_ts``. - -:math:`\phi_0` is the latitude of origin that match the center of the map. It can be set with ``+lat_0``. - - -Forward projection -================== - -.. math:: - - x = \lambda \cos \phi_{ts} - -.. math:: - - y = \phi - \phi_0 - -Inverse projection -================== - -.. math:: - - \lambda = x / cos \phi_{ts} - -.. math:: - - \phi = y + \phi_0 - - -Further reading -############### - -#. `Wikipedia `_ -#. `Wolfram Mathworld `_ - - diff --git a/docs/source/usage/operations/projections/eqdc.rst b/docs/source/usage/operations/projections/eqdc.rst deleted file mode 100644 index 3ee5999d..00000000 --- a/docs/source/usage/operations/projections/eqdc.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _eqdc: - -******************************************************************************** -Equidistant Conic -******************************************************************************** - -.. image:: ./images/eqdc.png - :scale: 50% - :alt: Equidistant Conic - diff --git a/docs/source/usage/operations/projections/etmerc.rst b/docs/source/usage/operations/projections/etmerc.rst deleted file mode 100644 index b7f89032..00000000 --- a/docs/source/usage/operations/projections/etmerc.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _etmerc: - -******************************************************************************** -Extended Transverse Mercator -******************************************************************************** - -.. image:: ./images/etmerc.png - :scale: 50% - :alt: Extended Transverse Mercator - diff --git a/docs/source/usage/operations/projections/euler.rst b/docs/source/usage/operations/projections/euler.rst deleted file mode 100644 index e495063f..00000000 --- a/docs/source/usage/operations/projections/euler.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _euler: - -******************************************************************************** -Euler -******************************************************************************** - -.. image:: ./images/euler.png - :scale: 50% - :alt: Euler - diff --git a/docs/source/usage/operations/projections/fahey.rst b/docs/source/usage/operations/projections/fahey.rst deleted file mode 100644 index 2e09337f..00000000 --- a/docs/source/usage/operations/projections/fahey.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _fahey: - -******************************************************************************** -Fahey -******************************************************************************** - -.. image:: ./images/fahey.png - :scale: 50% - :alt: Fahey - diff --git a/docs/source/usage/operations/projections/fouc.rst b/docs/source/usage/operations/projections/fouc.rst deleted file mode 100644 index 7467dcb1..00000000 --- a/docs/source/usage/operations/projections/fouc.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _fouc: - -******************************************************************************** -Foucaut -******************************************************************************** - -.. image:: ./images/fouc.png - :scale: 50% - :alt: Foucaut - diff --git a/docs/source/usage/operations/projections/fouc_s.rst b/docs/source/usage/operations/projections/fouc_s.rst deleted file mode 100644 index ac353adb..00000000 --- a/docs/source/usage/operations/projections/fouc_s.rst +++ /dev/null @@ -1,25 +0,0 @@ -.. _fouc_s: - -******************************************************************************** -Foucaut Sinusoidal -******************************************************************************** - -.. image:: ./images/fouc_s.png - :scale: 50% - :alt: Foucaut Sinusoidal - - -The `y`-axis is based upon a weighted mean of the cylindrical equal-area and -the sinusoidal projections. Parameter :math:`n=n` is the weighting factor where -:math:`0 <= n <= 1`. - -.. math:: - - x &= \lambda \cos \phi / (n + (1 - n) \ cos \phi) - - y &= n \phi + (1 - n) \sin \phi - -For the inverse, the Newton-Raphson method can be used to determine -:math:`\phi` from the equation for :math:`y` above. As :math:`n \rightarrow 0` and -:math:`\phi \rightarrow \pi/2`, convergence is slow but for :math:`n = 0`, :math:`\phi = -\sin^1y` diff --git a/docs/source/usage/operations/projections/gall.rst b/docs/source/usage/operations/projections/gall.rst deleted file mode 100644 index b9120d9f..00000000 --- a/docs/source/usage/operations/projections/gall.rst +++ /dev/null @@ -1,84 +0,0 @@ -.. _gall: - -******************************************************************************** -Gall (Gall Stereographic) -******************************************************************************** - -The Gall stereographic projection, presented by James Gall in 1855, is a cylindrical projection. -It is neither equal-area nor conformal but instead tries to balance the distortion inherent in any projection. - -+---------------------+--------------------------------------------------------------------------------+ -| **Classification** | Transverse and oblique cylindrical | -+---------------------+--------------------------------------------------------------------------------+ -| **Available forms** | Forward and inverse, Spherical | -+---------------------+--------------------------------------------------------------------------------+ -| **Defined area** | Global | -+---------------------+--------------------------------------------------------------------------------+ -| **Implemented by** | Gerald I. Evenden | -+---------------------+--------------------------------------------------------------------------------+ -| **Options** | No special options for this projection | -+---------------------+--------------------------------------------------------------------------------+ - - -.. image:: ./images/gall.png - :scale: 50% - :alt: Gall (Gall Stereographic) - -Usage -##### - -The need for a world map which avoids some of the scale exaggeration of the Mercator projection has led to some commonly used cylindrical modifications, as well as to other modifications which are not cylindrical. -The earliest common cylindrical example was developed by James Gall of Edinburgh about 1855 (Gall, 1885, p. 119-123). -His meridians are equally spaced, but the parallels are spaced at increasing intervals away from the Equator. -The parallels of latitude are actually projected onto a cylinder wrapped about the sphere, but cutting it at lats. 45° N. and S., the point of perspective being a point on the Equator opposite the meridian being projected. -It is used in several British atlases, but seldom in the United States. -The Gall projection is neither conformal nor equal-area, but has a blend of various features. -Unlike the Mercator, the Gall shows the poles as lines running across the top and bottom of the map. - - -Example using Gall Stereographical :: - - $ echo 9 51 | proj +proj=gall +lon_0=0 +x_0=0 +y_0=0 +ellps=WGS84 +datum=WGS84 +units=m +no_defs - 708432.90 5193386.36 - -Example using Gall Stereographical (Central meridian 90°W) :: - - $ echo 9 51 | proj +proj=gall +lon_0=90w +x_0=0 +y_0=0 +ellps=WGS84 +datum=WGS84 +units=m +no_defs - 7792761.91 5193386.36 - -Mathematical definition -####################### - -The formulas describing the Gall Stereographical are all taken from Snyder's [Snyder1993]_. - -Spherical form -************** - -Forward projection -================== - -.. math:: - - x = \frac{\lambda}{\sqrt{2}} - -.. math:: - - y = (1+\frac{\sqrt{2}}{2}) \tan(\phi/2) - -Inverse projection -================== - -.. math:: - - \phi = 2 \arctan( \frac{y}{1+\frac{\sqrt{2}}{2}} ) - -.. math:: - - \lambda = \sqrt{2} x - - -Further reading -############### - -#. `Wikipedia `_ -#. `Cartographic Projection Procedures for the UNIX Environment-A User's Manual `_ diff --git a/docs/source/usage/operations/projections/geos.rst b/docs/source/usage/operations/projections/geos.rst deleted file mode 100644 index 670985ae..00000000 --- a/docs/source/usage/operations/projections/geos.rst +++ /dev/null @@ -1,72 +0,0 @@ -.. _geos: - -******************************************************************************** -Geostationary Satellite View -******************************************************************************** -+---------------------+----------------------------------------------------------+ -| **Classification** | Azimuthal | -+---------------------+----------------------------------------------------------+ -| **Available forms** | Forward and inverse, spherical and elliptical projection | -+---------------------+----------------------------------------------------------+ -| **Defined area** | Global | -+---------------------+----------------------------------------------------------+ -| **Implemented by** | Gerald I. Evenden and Martin Raspaud | -+---------------------+----------------------------------------------------------+ -| **Options** | -+---------------------+----------------------------------------------------------+ -| `+h` | Satellite height above earth. Required. | -+---------------------+----------------------------------------------------------+ -| `+sweep` | Sweep angle axis of the viewing instrument. | -| | Valid options are ``x`` and ``y``. Defaults to ``y``. | -+---------------------+----------------------------------------------------------+ -| `+lon_0` | Subsatellite longitude point. | -+---------------------+----------------------------------------------------------+ - - -.. image:: ./images/geos.png - :scale: 50% - :alt: Geostationary Satellite View - -The geos projection pictures how a geostationary satellite scans the earth at regular -scanning angle intervals. - - -Usage -############################################################################### - -In order to project using the geos projection you can do the following:: - - proj +proj=geos +h=35785831.0 - -The required argument ``h`` is the viewing point (satellite position) height above -the earth. - -The projection coordinate relate to the scanning angle by the following simple -relation:: - - scanning_angle (radians) = projection_coordinate / h - - -Note on sweep angle -------------------------------------------------------------------------------- - -The viewing instrument on-board geostationary satellites described by this -projection have a two-axis gimbal viewing geometry. This means that the different -scanning positions are obtained by rotating the gimbal along a N/S axis (or ``y``) -and a E/W axis (or ``x``). - -.. image:: ../../../../images/geos_sweep.png - :scale: 50% - :alt: Gimbal geometry - -In the image above, the outer-gimbal axis, or sweep-angle axis, is the N/S axis (``y``) -while the inner-gimbal axis, or fixed-angle axis, is the E/W axis (``x``). - -This example represents the scanning geometry of the Meteosat series satellite. -However, the GOES satellite series use the opposite scanning geometry, with the -E/W axis (``x``) as the sweep-angle axis, and the N/S (``y``) as the fixed-angle axis. - -The sweep argument is used to tell PROJ which on which axis the outer-gimbal -is rotating. The possible values are x or y, y being the default. Thus, the -scanning geometry of the Meteosat series satellite should take sweep as x, and -GOES should take sweep as y. diff --git a/docs/source/usage/operations/projections/gins8.rst b/docs/source/usage/operations/projections/gins8.rst deleted file mode 100644 index f6adb092..00000000 --- a/docs/source/usage/operations/projections/gins8.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _gins8: - -******************************************************************************** -Ginsburg VIII (TsNIIGAiK) -******************************************************************************** - -.. image:: ./images/gins8.png - :scale: 50% - :alt: Ginsburg VIII (TsNIIGAiK) - diff --git a/docs/source/usage/operations/projections/gn_sinu.rst b/docs/source/usage/operations/projections/gn_sinu.rst deleted file mode 100644 index c1017c27..00000000 --- a/docs/source/usage/operations/projections/gn_sinu.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _gn_sinu: - -******************************************************************************** -General Sinusoidal Series -******************************************************************************** - -.. image:: ./images/gn_sinu.png - :scale: 50% - :alt: General Sinusoidal Series - diff --git a/docs/source/usage/operations/projections/gnom.rst b/docs/source/usage/operations/projections/gnom.rst deleted file mode 100644 index 08d0db5f..00000000 --- a/docs/source/usage/operations/projections/gnom.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _gnom: - -******************************************************************************** -Gnomonic -******************************************************************************** - -.. image:: ./images/gnom.png - :scale: 50% - :alt: Gnomonic - diff --git a/docs/source/usage/operations/projections/goode.rst b/docs/source/usage/operations/projections/goode.rst deleted file mode 100644 index c4590bf2..00000000 --- a/docs/source/usage/operations/projections/goode.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _goode: - -******************************************************************************** -Goode Homolosine -******************************************************************************** - -.. image:: ./images/goode.png - :scale: 50% - :alt: Goode Homolosine - diff --git a/docs/source/usage/operations/projections/gs48.rst b/docs/source/usage/operations/projections/gs48.rst deleted file mode 100644 index bdaa367c..00000000 --- a/docs/source/usage/operations/projections/gs48.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _gs48: - -******************************************************************************** -Mod. Stererographics of 48 U.S. -******************************************************************************** - -.. image:: ./images/gs48.png - :scale: 50% - :alt: Mod. Stererographics of 48 U.S. - diff --git a/docs/source/usage/operations/projections/gs50.rst b/docs/source/usage/operations/projections/gs50.rst deleted file mode 100644 index 0d4b7e81..00000000 --- a/docs/source/usage/operations/projections/gs50.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _gs50: - -******************************************************************************** -Mod. Stererographics of 50 U.S. -******************************************************************************** - -.. image:: ./images/gs50.png - :scale: 50% - :alt: Mod. Stererographics of 50 U.S. - diff --git a/docs/source/usage/operations/projections/gstmerc.rst b/docs/source/usage/operations/projections/gstmerc.rst deleted file mode 100644 index fc587ab0..00000000 --- a/docs/source/usage/operations/projections/gstmerc.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _gstmerc: - -******************************************************************************** -Gauss-Schreiber Transverse Mercator (aka Gauss-Laborde Reunion) -******************************************************************************** - -.. image:: ./images/gstmerc.png - :scale: 50% - :alt: Gauss-Schreiber Transverse Mercator (aka Gauss-Laborde Reunion) - diff --git a/docs/source/usage/operations/projections/hammer.rst b/docs/source/usage/operations/projections/hammer.rst deleted file mode 100644 index e795b91b..00000000 --- a/docs/source/usage/operations/projections/hammer.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _hammer: - -******************************************************************************** -Hammer & Eckert-Greifendorff -******************************************************************************** - -.. image:: ./images/hammer.png - :scale: 50% - :alt: Hammer & Eckert-Greifendorff - diff --git a/docs/source/usage/operations/projections/hatano.rst b/docs/source/usage/operations/projections/hatano.rst deleted file mode 100644 index 5d0c63b7..00000000 --- a/docs/source/usage/operations/projections/hatano.rst +++ /dev/null @@ -1,70 +0,0 @@ -.. _hatano: - -******************************************************************************** -Hatano Asymmetrical Equal Area -******************************************************************************** - - - - -+---------------------+----------------------------------------------------------+ -| **Classification** | :term:`Pseudocylindrical Projection` | -+---------------------+----------------------------------------------------------+ -| **Available forms** | Forward and inverse, spherical projection | -+---------------------+----------------------------------------------------------+ -| **Defined area** | Global, but best between standard parallels | -+---------------------+----------------------------------------------------------+ -| **Implemented by** | Gerald I. Evenden | -+---------------------+----------------------------------------------------------+ -| **Options** | -+---------------------+----------------------------------------------------------+ -| `+lat_1` | Standard Parallel 1 | -+---------------------+----------------------------------------------------------+ -| `+lat_2` | Standard Parallel 2 | -+---------------------+----------------------------------------------------------+ -| `+sym` | Symmetric form used instead of asymmetric | -+---------------------+----------------------------------------------------------+ - - -.. image:: ./images/hatano.png - :scale: 50% - :alt: Hatano Asymmetrical Equal Area - - - -Mathematical Definition --------------------------------------------------------------------------------- - -Forward -................................................................................ - -.. math:: - - x &= 0.85\lambda \cos \theta - - y &= C_y \sin \theta - - P(\theta) &= 2\theta + \sin 2\theta - C_p \sin \phi - - P'(\theta) &= 2(1 + \cos 2\theta) - - \theta_0 &= 2\phi - - -==================================== ================== =================== -Condition :math:`C_p` :math:`C_p` -==================================== ================== =================== -if ``+sym`` or :math:`\phi > 0` 1.75859 2.67595 -if not ``+sym`` and :math:`\phi < 0` 1.93052 2.43763 -==================================== ================== =================== - -For :math:`\phi = 0`, :math:`y \leftarrow 0`, and :math:`x \leftarrow 0.85\lambda`. - -Further reading --------------------------------------------------------------------------------- - -#. `Compare Map Projections `__ -#. `Mathworks `__ - - - diff --git a/docs/source/usage/operations/projections/healpix.rst b/docs/source/usage/operations/projections/healpix.rst deleted file mode 100644 index 20815d76..00000000 --- a/docs/source/usage/operations/projections/healpix.rst +++ /dev/null @@ -1,55 +0,0 @@ -.. _healpix: - -******************************************************************************** -HEALPix -******************************************************************************** -+---------------------+----------------------------------------------------------+ -| **Classification** | Mixed | -+---------------------+----------------------------------------------------------+ -| **Available forms** | Forward and inverse, spherical and elliptical projection | -+---------------------+----------------------------------------------------------+ -| **Defined area** | Global | -+---------------------+----------------------------------------------------------+ -| **Implemented by** | Alex Raichev and Michael Speth | -+---------------------+----------------------------------------------------------+ -| **Options** | -+---------------------+----------------------------------------------------------+ -| `No special options for this projection` | -+---------------------+----------------------------------------------------------+ - -.. image:: ../../../../images/healpix.png - :scale: 75% - :alt: HEALPix - -The HEALPix projection is area preserving and can be used with a spherical and -ellipsoidal model. It was initially developed for mapping cosmic background -microwave radiation. The image below is the graphical representation of the -mapping and consists of eight isomorphic triangular interrupted map graticules. -The north and south contains four in which straight meridians converge polewards -to a point and unequally spaced horizontal parallels. HEALPix provides a mapping -in which points of equal latitude and equally spaced longitude are mapped to points -of equal latitude and equally spaced longitude with the module of the polar -interruptions. - - -Usage -############################################################################### - -To run a forward HEALPix projection on a unit sphere model, use the following command:: - - proj +proj=healpix +lon_0=0 +a=1 -E <`_ -#. `Wikipedia `_ - - - - - diff --git a/docs/source/usage/operations/projections/igh.rst b/docs/source/usage/operations/projections/igh.rst deleted file mode 100644 index d74e1362..00000000 --- a/docs/source/usage/operations/projections/igh.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _igh: - -******************************************************************************** -Interrupted Goode Homolosine -******************************************************************************** - -.. image:: ./images/igh.png - :scale: 50% - :alt: Interrupted Goode Homolosine - diff --git a/docs/source/usage/operations/projections/images/aea.png b/docs/source/usage/operations/projections/images/aea.png deleted file mode 100644 index 7fdd4ece..00000000 Binary files a/docs/source/usage/operations/projections/images/aea.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/aeqd.png b/docs/source/usage/operations/projections/images/aeqd.png deleted file mode 100644 index 8e45b2c0..00000000 Binary files a/docs/source/usage/operations/projections/images/aeqd.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/airy.png b/docs/source/usage/operations/projections/images/airy.png deleted file mode 100644 index a441e317..00000000 Binary files a/docs/source/usage/operations/projections/images/airy.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/aitoff.png b/docs/source/usage/operations/projections/images/aitoff.png deleted file mode 100644 index 3449dcd5..00000000 Binary files a/docs/source/usage/operations/projections/images/aitoff.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/alsk.png b/docs/source/usage/operations/projections/images/alsk.png deleted file mode 100644 index 6f6e2014..00000000 Binary files a/docs/source/usage/operations/projections/images/alsk.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/apian.png b/docs/source/usage/operations/projections/images/apian.png deleted file mode 100644 index 95857ae3..00000000 Binary files a/docs/source/usage/operations/projections/images/apian.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/august.png b/docs/source/usage/operations/projections/images/august.png deleted file mode 100644 index 9d9fece6..00000000 Binary files a/docs/source/usage/operations/projections/images/august.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/bacon.png b/docs/source/usage/operations/projections/images/bacon.png deleted file mode 100644 index 62deae63..00000000 Binary files a/docs/source/usage/operations/projections/images/bacon.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/bipc.png b/docs/source/usage/operations/projections/images/bipc.png deleted file mode 100644 index 7b8ab39c..00000000 Binary files a/docs/source/usage/operations/projections/images/bipc.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/boggs.png b/docs/source/usage/operations/projections/images/boggs.png deleted file mode 100644 index 42dd4c13..00000000 Binary files a/docs/source/usage/operations/projections/images/boggs.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/bonne.png b/docs/source/usage/operations/projections/images/bonne.png deleted file mode 100644 index 12f93217..00000000 Binary files a/docs/source/usage/operations/projections/images/bonne.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/calcofi.png b/docs/source/usage/operations/projections/images/calcofi.png deleted file mode 100644 index 2fd405ac..00000000 Binary files a/docs/source/usage/operations/projections/images/calcofi.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/cass.png b/docs/source/usage/operations/projections/images/cass.png deleted file mode 100644 index e44c46af..00000000 Binary files a/docs/source/usage/operations/projections/images/cass.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/cc.png b/docs/source/usage/operations/projections/images/cc.png deleted file mode 100644 index 3beaedfd..00000000 Binary files a/docs/source/usage/operations/projections/images/cc.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/ccon.png b/docs/source/usage/operations/projections/images/ccon.png deleted file mode 100644 index ccc0ec9e..00000000 Binary files a/docs/source/usage/operations/projections/images/ccon.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/cea.png b/docs/source/usage/operations/projections/images/cea.png deleted file mode 100644 index eca2319d..00000000 Binary files a/docs/source/usage/operations/projections/images/cea.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/chamb.png b/docs/source/usage/operations/projections/images/chamb.png deleted file mode 100644 index a87e6c68..00000000 Binary files a/docs/source/usage/operations/projections/images/chamb.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/collg.png b/docs/source/usage/operations/projections/images/collg.png deleted file mode 100644 index 851201da..00000000 Binary files a/docs/source/usage/operations/projections/images/collg.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/comill.png b/docs/source/usage/operations/projections/images/comill.png deleted file mode 100644 index 725a0118..00000000 Binary files a/docs/source/usage/operations/projections/images/comill.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/crast.png b/docs/source/usage/operations/projections/images/crast.png deleted file mode 100644 index abd4d32a..00000000 Binary files a/docs/source/usage/operations/projections/images/crast.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/denoy.png b/docs/source/usage/operations/projections/images/denoy.png deleted file mode 100644 index 2871cf84..00000000 Binary files a/docs/source/usage/operations/projections/images/denoy.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/eck1.png b/docs/source/usage/operations/projections/images/eck1.png deleted file mode 100644 index b892d39e..00000000 Binary files a/docs/source/usage/operations/projections/images/eck1.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/eck2.png b/docs/source/usage/operations/projections/images/eck2.png deleted file mode 100644 index ff011598..00000000 Binary files a/docs/source/usage/operations/projections/images/eck2.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/eck3.png b/docs/source/usage/operations/projections/images/eck3.png deleted file mode 100644 index f828eed0..00000000 Binary files a/docs/source/usage/operations/projections/images/eck3.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/eck4.png b/docs/source/usage/operations/projections/images/eck4.png deleted file mode 100644 index d7ff87bb..00000000 Binary files a/docs/source/usage/operations/projections/images/eck4.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/eck5.png b/docs/source/usage/operations/projections/images/eck5.png deleted file mode 100644 index 3df303c6..00000000 Binary files a/docs/source/usage/operations/projections/images/eck5.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/eck6.png b/docs/source/usage/operations/projections/images/eck6.png deleted file mode 100644 index d22f4956..00000000 Binary files a/docs/source/usage/operations/projections/images/eck6.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/eqc.png b/docs/source/usage/operations/projections/images/eqc.png deleted file mode 100644 index b2d8ba23..00000000 Binary files a/docs/source/usage/operations/projections/images/eqc.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/eqdc.png b/docs/source/usage/operations/projections/images/eqdc.png deleted file mode 100644 index f2330a8e..00000000 Binary files a/docs/source/usage/operations/projections/images/eqdc.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/etmerc.png b/docs/source/usage/operations/projections/images/etmerc.png deleted file mode 100644 index 8e6bb39b..00000000 Binary files a/docs/source/usage/operations/projections/images/etmerc.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/euler.png b/docs/source/usage/operations/projections/images/euler.png deleted file mode 100644 index c9c6e4c8..00000000 Binary files a/docs/source/usage/operations/projections/images/euler.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/fahey.png b/docs/source/usage/operations/projections/images/fahey.png deleted file mode 100644 index 8b870b8a..00000000 Binary files a/docs/source/usage/operations/projections/images/fahey.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/fouc.png b/docs/source/usage/operations/projections/images/fouc.png deleted file mode 100644 index 6d33216b..00000000 Binary files a/docs/source/usage/operations/projections/images/fouc.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/fouc_s.png b/docs/source/usage/operations/projections/images/fouc_s.png deleted file mode 100644 index 401f5ee4..00000000 Binary files a/docs/source/usage/operations/projections/images/fouc_s.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/gall.png b/docs/source/usage/operations/projections/images/gall.png deleted file mode 100644 index 819b5d12..00000000 Binary files a/docs/source/usage/operations/projections/images/gall.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/geos.png b/docs/source/usage/operations/projections/images/geos.png deleted file mode 100644 index e44fa41b..00000000 Binary files a/docs/source/usage/operations/projections/images/geos.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/gins8.png b/docs/source/usage/operations/projections/images/gins8.png deleted file mode 100644 index 12fbae93..00000000 Binary files a/docs/source/usage/operations/projections/images/gins8.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/gn_sinu.png b/docs/source/usage/operations/projections/images/gn_sinu.png deleted file mode 100644 index f02e119e..00000000 Binary files a/docs/source/usage/operations/projections/images/gn_sinu.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/gnom.png b/docs/source/usage/operations/projections/images/gnom.png deleted file mode 100644 index c079d31a..00000000 Binary files a/docs/source/usage/operations/projections/images/gnom.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/goode.png b/docs/source/usage/operations/projections/images/goode.png deleted file mode 100644 index 7001e8d2..00000000 Binary files a/docs/source/usage/operations/projections/images/goode.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/gs48.png b/docs/source/usage/operations/projections/images/gs48.png deleted file mode 100644 index 574e368f..00000000 Binary files a/docs/source/usage/operations/projections/images/gs48.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/gs50.png b/docs/source/usage/operations/projections/images/gs50.png deleted file mode 100644 index 7244b160..00000000 Binary files a/docs/source/usage/operations/projections/images/gs50.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/gstmerc.png b/docs/source/usage/operations/projections/images/gstmerc.png deleted file mode 100644 index d553ea60..00000000 Binary files a/docs/source/usage/operations/projections/images/gstmerc.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/hammer.png b/docs/source/usage/operations/projections/images/hammer.png deleted file mode 100644 index 83848479..00000000 Binary files a/docs/source/usage/operations/projections/images/hammer.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/hatano.png b/docs/source/usage/operations/projections/images/hatano.png deleted file mode 100644 index b3f47377..00000000 Binary files a/docs/source/usage/operations/projections/images/hatano.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/healpix.png b/docs/source/usage/operations/projections/images/healpix.png deleted file mode 100644 index c58a155c..00000000 Binary files a/docs/source/usage/operations/projections/images/healpix.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/igh.png b/docs/source/usage/operations/projections/images/igh.png deleted file mode 100644 index 36336eec..00000000 Binary files a/docs/source/usage/operations/projections/images/igh.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/imw_p.png b/docs/source/usage/operations/projections/images/imw_p.png deleted file mode 100644 index 74cfe81b..00000000 Binary files a/docs/source/usage/operations/projections/images/imw_p.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/isea.png b/docs/source/usage/operations/projections/images/isea.png deleted file mode 100644 index 23cfbf74..00000000 Binary files a/docs/source/usage/operations/projections/images/isea.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/kav5.png b/docs/source/usage/operations/projections/images/kav5.png deleted file mode 100644 index d5c45400..00000000 Binary files a/docs/source/usage/operations/projections/images/kav5.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/kav7.png b/docs/source/usage/operations/projections/images/kav7.png deleted file mode 100644 index 50d7e6e6..00000000 Binary files a/docs/source/usage/operations/projections/images/kav7.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/krovak.png b/docs/source/usage/operations/projections/images/krovak.png deleted file mode 100644 index d0d69547..00000000 Binary files a/docs/source/usage/operations/projections/images/krovak.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/labrd.png b/docs/source/usage/operations/projections/images/labrd.png deleted file mode 100644 index e4a174c0..00000000 Binary files a/docs/source/usage/operations/projections/images/labrd.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/laea.png b/docs/source/usage/operations/projections/images/laea.png deleted file mode 100644 index f52c7c1f..00000000 Binary files a/docs/source/usage/operations/projections/images/laea.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/lagrng.png b/docs/source/usage/operations/projections/images/lagrng.png deleted file mode 100644 index e48210bb..00000000 Binary files a/docs/source/usage/operations/projections/images/lagrng.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/larr.png b/docs/source/usage/operations/projections/images/larr.png deleted file mode 100644 index 967b91d2..00000000 Binary files a/docs/source/usage/operations/projections/images/larr.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/lask.png b/docs/source/usage/operations/projections/images/lask.png deleted file mode 100644 index dff0e8fa..00000000 Binary files a/docs/source/usage/operations/projections/images/lask.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/lcc.png b/docs/source/usage/operations/projections/images/lcc.png deleted file mode 100644 index 4714b74e..00000000 Binary files a/docs/source/usage/operations/projections/images/lcc.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/lcca.png b/docs/source/usage/operations/projections/images/lcca.png deleted file mode 100644 index 0c404670..00000000 Binary files a/docs/source/usage/operations/projections/images/lcca.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/leac.png b/docs/source/usage/operations/projections/images/leac.png deleted file mode 100644 index 1f57d192..00000000 Binary files a/docs/source/usage/operations/projections/images/leac.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/lee_os.png b/docs/source/usage/operations/projections/images/lee_os.png deleted file mode 100644 index 3e258393..00000000 Binary files a/docs/source/usage/operations/projections/images/lee_os.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/loxim.png b/docs/source/usage/operations/projections/images/loxim.png deleted file mode 100644 index a03ba94e..00000000 Binary files a/docs/source/usage/operations/projections/images/loxim.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/lsat.png b/docs/source/usage/operations/projections/images/lsat.png deleted file mode 100644 index ec608544..00000000 Binary files a/docs/source/usage/operations/projections/images/lsat.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/mbt_fps.png b/docs/source/usage/operations/projections/images/mbt_fps.png deleted file mode 100644 index e97cd21e..00000000 Binary files a/docs/source/usage/operations/projections/images/mbt_fps.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/mbt_s.png b/docs/source/usage/operations/projections/images/mbt_s.png deleted file mode 100644 index 4432e83b..00000000 Binary files a/docs/source/usage/operations/projections/images/mbt_s.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/mbtfpp.png b/docs/source/usage/operations/projections/images/mbtfpp.png deleted file mode 100644 index 3d0c4fb5..00000000 Binary files a/docs/source/usage/operations/projections/images/mbtfpp.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/mbtfpq.png b/docs/source/usage/operations/projections/images/mbtfpq.png deleted file mode 100644 index b31c52ce..00000000 Binary files a/docs/source/usage/operations/projections/images/mbtfpq.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/mbtfps.png b/docs/source/usage/operations/projections/images/mbtfps.png deleted file mode 100644 index 83891be6..00000000 Binary files a/docs/source/usage/operations/projections/images/mbtfps.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/merc.png b/docs/source/usage/operations/projections/images/merc.png deleted file mode 100644 index 8202789e..00000000 Binary files a/docs/source/usage/operations/projections/images/merc.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/mil_os.png b/docs/source/usage/operations/projections/images/mil_os.png deleted file mode 100644 index 3316d317..00000000 Binary files a/docs/source/usage/operations/projections/images/mil_os.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/mill.png b/docs/source/usage/operations/projections/images/mill.png deleted file mode 100644 index f62e517c..00000000 Binary files a/docs/source/usage/operations/projections/images/mill.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/misrsom.png b/docs/source/usage/operations/projections/images/misrsom.png deleted file mode 100644 index 493baff3..00000000 Binary files a/docs/source/usage/operations/projections/images/misrsom.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/moll.png b/docs/source/usage/operations/projections/images/moll.png deleted file mode 100644 index 5d599579..00000000 Binary files a/docs/source/usage/operations/projections/images/moll.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/murd1.png b/docs/source/usage/operations/projections/images/murd1.png deleted file mode 100644 index 34d628c5..00000000 Binary files a/docs/source/usage/operations/projections/images/murd1.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/murd2.png b/docs/source/usage/operations/projections/images/murd2.png deleted file mode 100644 index b3fdabdd..00000000 Binary files a/docs/source/usage/operations/projections/images/murd2.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/murd3.png b/docs/source/usage/operations/projections/images/murd3.png deleted file mode 100644 index 354b009c..00000000 Binary files a/docs/source/usage/operations/projections/images/murd3.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/natearth.png b/docs/source/usage/operations/projections/images/natearth.png deleted file mode 100644 index 0e182a0b..00000000 Binary files a/docs/source/usage/operations/projections/images/natearth.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/natearth2.png b/docs/source/usage/operations/projections/images/natearth2.png deleted file mode 100644 index 3757646c..00000000 Binary files a/docs/source/usage/operations/projections/images/natearth2.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/nell.png b/docs/source/usage/operations/projections/images/nell.png deleted file mode 100644 index c0dbdcac..00000000 Binary files a/docs/source/usage/operations/projections/images/nell.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/nell_h.png b/docs/source/usage/operations/projections/images/nell_h.png deleted file mode 100644 index a5a27076..00000000 Binary files a/docs/source/usage/operations/projections/images/nell_h.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/nicol.png b/docs/source/usage/operations/projections/images/nicol.png deleted file mode 100644 index 711db115..00000000 Binary files a/docs/source/usage/operations/projections/images/nicol.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/nsper.png b/docs/source/usage/operations/projections/images/nsper.png deleted file mode 100644 index 06f210a1..00000000 Binary files a/docs/source/usage/operations/projections/images/nsper.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/nzmg.png b/docs/source/usage/operations/projections/images/nzmg.png deleted file mode 100644 index 3625f331..00000000 Binary files a/docs/source/usage/operations/projections/images/nzmg.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/ob_tran.png b/docs/source/usage/operations/projections/images/ob_tran.png deleted file mode 100644 index 9b1e0d44..00000000 Binary files a/docs/source/usage/operations/projections/images/ob_tran.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/ocea.png b/docs/source/usage/operations/projections/images/ocea.png deleted file mode 100644 index 41a5a813..00000000 Binary files a/docs/source/usage/operations/projections/images/ocea.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/oea.png b/docs/source/usage/operations/projections/images/oea.png deleted file mode 100644 index 601ead55..00000000 Binary files a/docs/source/usage/operations/projections/images/oea.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/omerc.png b/docs/source/usage/operations/projections/images/omerc.png deleted file mode 100644 index 50a3d2b7..00000000 Binary files a/docs/source/usage/operations/projections/images/omerc.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/ortel.png b/docs/source/usage/operations/projections/images/ortel.png deleted file mode 100644 index c6a5bf4f..00000000 Binary files a/docs/source/usage/operations/projections/images/ortel.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/ortho.png b/docs/source/usage/operations/projections/images/ortho.png deleted file mode 100644 index e8b0b9b2..00000000 Binary files a/docs/source/usage/operations/projections/images/ortho.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/patterson.png b/docs/source/usage/operations/projections/images/patterson.png deleted file mode 100644 index f8014249..00000000 Binary files a/docs/source/usage/operations/projections/images/patterson.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/pconic.png b/docs/source/usage/operations/projections/images/pconic.png deleted file mode 100644 index 7d7f9f92..00000000 Binary files a/docs/source/usage/operations/projections/images/pconic.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/poly.png b/docs/source/usage/operations/projections/images/poly.png deleted file mode 100644 index ccf25529..00000000 Binary files a/docs/source/usage/operations/projections/images/poly.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/putp1.png b/docs/source/usage/operations/projections/images/putp1.png deleted file mode 100644 index c81f574c..00000000 Binary files a/docs/source/usage/operations/projections/images/putp1.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/putp2.png b/docs/source/usage/operations/projections/images/putp2.png deleted file mode 100644 index 377a027c..00000000 Binary files a/docs/source/usage/operations/projections/images/putp2.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/putp3.png b/docs/source/usage/operations/projections/images/putp3.png deleted file mode 100644 index 08692ca1..00000000 Binary files a/docs/source/usage/operations/projections/images/putp3.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/putp3p.png b/docs/source/usage/operations/projections/images/putp3p.png deleted file mode 100644 index 9e42319c..00000000 Binary files a/docs/source/usage/operations/projections/images/putp3p.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/putp4p.png b/docs/source/usage/operations/projections/images/putp4p.png deleted file mode 100644 index 43cb10c6..00000000 Binary files a/docs/source/usage/operations/projections/images/putp4p.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/putp5.png b/docs/source/usage/operations/projections/images/putp5.png deleted file mode 100644 index 4e45de6d..00000000 Binary files a/docs/source/usage/operations/projections/images/putp5.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/putp5p.png b/docs/source/usage/operations/projections/images/putp5p.png deleted file mode 100644 index 76dcb767..00000000 Binary files a/docs/source/usage/operations/projections/images/putp5p.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/putp6.png b/docs/source/usage/operations/projections/images/putp6.png deleted file mode 100644 index c73585ee..00000000 Binary files a/docs/source/usage/operations/projections/images/putp6.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/putp6p.png b/docs/source/usage/operations/projections/images/putp6p.png deleted file mode 100644 index d64c2c20..00000000 Binary files a/docs/source/usage/operations/projections/images/putp6p.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/qsc.png b/docs/source/usage/operations/projections/images/qsc.png deleted file mode 100644 index 5824cf64..00000000 Binary files a/docs/source/usage/operations/projections/images/qsc.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/qua_aut.png b/docs/source/usage/operations/projections/images/qua_aut.png deleted file mode 100644 index 6bc2d811..00000000 Binary files a/docs/source/usage/operations/projections/images/qua_aut.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/rhealpix.png b/docs/source/usage/operations/projections/images/rhealpix.png deleted file mode 100644 index dc1c344a..00000000 Binary files a/docs/source/usage/operations/projections/images/rhealpix.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/robin.png b/docs/source/usage/operations/projections/images/robin.png deleted file mode 100644 index 42a49da2..00000000 Binary files a/docs/source/usage/operations/projections/images/robin.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/rouss.png b/docs/source/usage/operations/projections/images/rouss.png deleted file mode 100644 index 2eca0fed..00000000 Binary files a/docs/source/usage/operations/projections/images/rouss.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/rpoly.png b/docs/source/usage/operations/projections/images/rpoly.png deleted file mode 100644 index 343127c1..00000000 Binary files a/docs/source/usage/operations/projections/images/rpoly.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/sinu.png b/docs/source/usage/operations/projections/images/sinu.png deleted file mode 100644 index 9bef143a..00000000 Binary files a/docs/source/usage/operations/projections/images/sinu.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/somerc.png b/docs/source/usage/operations/projections/images/somerc.png deleted file mode 100644 index 1248e6ea..00000000 Binary files a/docs/source/usage/operations/projections/images/somerc.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/stere.png b/docs/source/usage/operations/projections/images/stere.png deleted file mode 100644 index 840050f0..00000000 Binary files a/docs/source/usage/operations/projections/images/stere.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/sterea.png b/docs/source/usage/operations/projections/images/sterea.png deleted file mode 100644 index d2aad552..00000000 Binary files a/docs/source/usage/operations/projections/images/sterea.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/tcc.png b/docs/source/usage/operations/projections/images/tcc.png deleted file mode 100644 index f968f62d..00000000 Binary files a/docs/source/usage/operations/projections/images/tcc.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/tcea.png b/docs/source/usage/operations/projections/images/tcea.png deleted file mode 100644 index 44212bd8..00000000 Binary files a/docs/source/usage/operations/projections/images/tcea.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/tissot.png b/docs/source/usage/operations/projections/images/tissot.png deleted file mode 100644 index 2f785477..00000000 Binary files a/docs/source/usage/operations/projections/images/tissot.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/tmerc.png b/docs/source/usage/operations/projections/images/tmerc.png deleted file mode 100644 index b206c502..00000000 Binary files a/docs/source/usage/operations/projections/images/tmerc.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/tpeqd.png b/docs/source/usage/operations/projections/images/tpeqd.png deleted file mode 100644 index 50291b68..00000000 Binary files a/docs/source/usage/operations/projections/images/tpeqd.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/tpers.png b/docs/source/usage/operations/projections/images/tpers.png deleted file mode 100644 index 480f6dce..00000000 Binary files a/docs/source/usage/operations/projections/images/tpers.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/ups.png b/docs/source/usage/operations/projections/images/ups.png deleted file mode 100644 index 354b64ac..00000000 Binary files a/docs/source/usage/operations/projections/images/ups.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/urm5.png b/docs/source/usage/operations/projections/images/urm5.png deleted file mode 100644 index 088671c9..00000000 Binary files a/docs/source/usage/operations/projections/images/urm5.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/urmfps.png b/docs/source/usage/operations/projections/images/urmfps.png deleted file mode 100644 index 86432790..00000000 Binary files a/docs/source/usage/operations/projections/images/urmfps.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/utm.png b/docs/source/usage/operations/projections/images/utm.png deleted file mode 100644 index 3dcd5ee0..00000000 Binary files a/docs/source/usage/operations/projections/images/utm.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/vandg.png b/docs/source/usage/operations/projections/images/vandg.png deleted file mode 100644 index 46fe2346..00000000 Binary files a/docs/source/usage/operations/projections/images/vandg.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/vandg2.png b/docs/source/usage/operations/projections/images/vandg2.png deleted file mode 100644 index 597b5ae1..00000000 Binary files a/docs/source/usage/operations/projections/images/vandg2.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/vandg3.png b/docs/source/usage/operations/projections/images/vandg3.png deleted file mode 100644 index 36d1ad04..00000000 Binary files a/docs/source/usage/operations/projections/images/vandg3.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/vandg4.png b/docs/source/usage/operations/projections/images/vandg4.png deleted file mode 100644 index 163c1558..00000000 Binary files a/docs/source/usage/operations/projections/images/vandg4.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/vitk1.png b/docs/source/usage/operations/projections/images/vitk1.png deleted file mode 100644 index 31034b3a..00000000 Binary files a/docs/source/usage/operations/projections/images/vitk1.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/wag1.png b/docs/source/usage/operations/projections/images/wag1.png deleted file mode 100644 index a2bc8adc..00000000 Binary files a/docs/source/usage/operations/projections/images/wag1.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/wag2.png b/docs/source/usage/operations/projections/images/wag2.png deleted file mode 100644 index b4abb48c..00000000 Binary files a/docs/source/usage/operations/projections/images/wag2.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/wag3.png b/docs/source/usage/operations/projections/images/wag3.png deleted file mode 100644 index a2053815..00000000 Binary files a/docs/source/usage/operations/projections/images/wag3.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/wag4.png b/docs/source/usage/operations/projections/images/wag4.png deleted file mode 100644 index 7d1c50b3..00000000 Binary files a/docs/source/usage/operations/projections/images/wag4.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/wag5.png b/docs/source/usage/operations/projections/images/wag5.png deleted file mode 100644 index 487f6022..00000000 Binary files a/docs/source/usage/operations/projections/images/wag5.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/wag6.png b/docs/source/usage/operations/projections/images/wag6.png deleted file mode 100644 index dd49e8d0..00000000 Binary files a/docs/source/usage/operations/projections/images/wag6.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/wag7.png b/docs/source/usage/operations/projections/images/wag7.png deleted file mode 100644 index b9682755..00000000 Binary files a/docs/source/usage/operations/projections/images/wag7.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/weren.png b/docs/source/usage/operations/projections/images/weren.png deleted file mode 100644 index 7deb132f..00000000 Binary files a/docs/source/usage/operations/projections/images/weren.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/wink1.png b/docs/source/usage/operations/projections/images/wink1.png deleted file mode 100644 index 6cbf48ae..00000000 Binary files a/docs/source/usage/operations/projections/images/wink1.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/wink2.png b/docs/source/usage/operations/projections/images/wink2.png deleted file mode 100644 index 21a23634..00000000 Binary files a/docs/source/usage/operations/projections/images/wink2.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/images/wintri.png b/docs/source/usage/operations/projections/images/wintri.png deleted file mode 100644 index 54a0a85a..00000000 Binary files a/docs/source/usage/operations/projections/images/wintri.png and /dev/null differ diff --git a/docs/source/usage/operations/projections/imw_p.rst b/docs/source/usage/operations/projections/imw_p.rst deleted file mode 100644 index 1fd3ded0..00000000 --- a/docs/source/usage/operations/projections/imw_p.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _imw_p: - -******************************************************************************** -International Map of the World Polyconic -******************************************************************************** - -.. image:: ./images/imw_p.png - :scale: 50% - :alt: International Map of the World Polyconic - diff --git a/docs/source/usage/operations/projections/index.rst b/docs/source/usage/operations/projections/index.rst deleted file mode 100644 index 904dc9e6..00000000 --- a/docs/source/usage/operations/projections/index.rst +++ /dev/null @@ -1,146 +0,0 @@ -.. _projections: - -================================================================================ -Projections -================================================================================ - -Projections are coordinate operations that are technically conversions but since -projections are so fundamental to PROJ we differentiate them from conversions. - -Projections map the spherical 3D space to a flat 2D space. - -.. toctree:: - :maxdepth: 1 - - aeqd - airy - aitoff - alsk - apian - august - bacon - bipc - boggs - bonne - calcofi - cass - cc - ccon - cea - chamb - collg - crast - denoy - eck1 - eck2 - eck3 - eck4 - eck5 - eck6 - eqc - eqdc - euler - etmerc - fahey - fouc - fouc_s - gall - geos - gins8 - gn_sinu - gnom - goode - gs48 - gs50 - hammer - hatano - healpix - rhealpix - igh - imw_p - isea - kav5 - kav7 - krovak - labrd - laea - lagrng - larr - lask - lcc - lcca - leac - lee_os - loxim - lsat - mbt_s - mbt_fps - mbtfpp - mbtfpq - mbtfps - merc - mil_os - mill - moll - murd1 - murd2 - murd3 - natearth - nell - nell_h - nicol - nsper - nzmg - ob_tran - ocea - oea - omerc - ortel - ortho - pconic - poly - putp1 - putp2 - putp3 - putp3p - putp4p - putp5 - putp5p - putp6 - putp6p - qua_aut - qsc - robin - rouss - rpoly - sinu - somerc - stere - sterea - gstmerc - tcc - tcea - tissot - tmerc - tpeqd - tpers - ups - urm5 - urmfps - utm - vandg - vandg2 - vandg3 - vandg4 - vitk1 - wag1 - wag2 - wag3 - wag4 - wag5 - wag6 - wag7 - weren - wink1 - wink2 - wintri diff --git a/docs/source/usage/operations/projections/isea.rst b/docs/source/usage/operations/projections/isea.rst deleted file mode 100644 index 1b6457af..00000000 --- a/docs/source/usage/operations/projections/isea.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _isea: - -******************************************************************************** -Icosahedral Snyder Equal Area -******************************************************************************** - -.. image:: ./images/isea.png - :scale: 50% - :alt: Icosahedral Snyder Equal Area - diff --git a/docs/source/usage/operations/projections/kav5.rst b/docs/source/usage/operations/projections/kav5.rst deleted file mode 100644 index 2ec5d1c1..00000000 --- a/docs/source/usage/operations/projections/kav5.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _kav5: - -******************************************************************************** -Kavraisky V -******************************************************************************** - -.. image:: ./images/kav5.png - :scale: 50% - :alt: Kavraisky V - diff --git a/docs/source/usage/operations/projections/kav7.rst b/docs/source/usage/operations/projections/kav7.rst deleted file mode 100644 index 8371e6ea..00000000 --- a/docs/source/usage/operations/projections/kav7.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _kav7: - -******************************************************************************** -Kavraisky VII -******************************************************************************** - -.. image:: ./images/kav7.png - :scale: 50% - :alt: Kavraisky VII - diff --git a/docs/source/usage/operations/projections/krovak.rst b/docs/source/usage/operations/projections/krovak.rst deleted file mode 100644 index 6c774825..00000000 --- a/docs/source/usage/operations/projections/krovak.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _krovak: - -******************************************************************************** -Krovak -******************************************************************************** - -.. image:: ./images/krovak.png - :scale: 50% - :alt: Krovak - diff --git a/docs/source/usage/operations/projections/labrd.rst b/docs/source/usage/operations/projections/labrd.rst deleted file mode 100644 index 5be58db5..00000000 --- a/docs/source/usage/operations/projections/labrd.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _labrd: - -******************************************************************************** -Laborde -******************************************************************************** - -.. image:: ./images/labrd.png - :scale: 50% - :alt: Laborde - diff --git a/docs/source/usage/operations/projections/laea.rst b/docs/source/usage/operations/projections/laea.rst deleted file mode 100644 index 2377f294..00000000 --- a/docs/source/usage/operations/projections/laea.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _laea: - -******************************************************************************** -Lambert Azimuthal Equal Area -******************************************************************************** - -.. image:: ./images/laea.png - :scale: 50% - :alt: Lambert Azimuthal Equal Area - diff --git a/docs/source/usage/operations/projections/lagrng.rst b/docs/source/usage/operations/projections/lagrng.rst deleted file mode 100644 index de9e5640..00000000 --- a/docs/source/usage/operations/projections/lagrng.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _lagrng: - -******************************************************************************** -Lagrange -******************************************************************************** - -.. image:: ./images/lagrng.png - :scale: 50% - :alt: Lagrange - diff --git a/docs/source/usage/operations/projections/larr.rst b/docs/source/usage/operations/projections/larr.rst deleted file mode 100644 index 9529f83f..00000000 --- a/docs/source/usage/operations/projections/larr.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _larr: - -******************************************************************************** -Larrivee -******************************************************************************** - -.. image:: ./images/larr.png - :scale: 50% - :alt: Larrivee - diff --git a/docs/source/usage/operations/projections/lask.rst b/docs/source/usage/operations/projections/lask.rst deleted file mode 100644 index d34dc8a0..00000000 --- a/docs/source/usage/operations/projections/lask.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _lask: - -******************************************************************************** -Laskowski -******************************************************************************** - -.. image:: ./images/lask.png - :scale: 50% - :alt: Laskowski - diff --git a/docs/source/usage/operations/projections/lcc.rst b/docs/source/usage/operations/projections/lcc.rst deleted file mode 100644 index a3075e76..00000000 --- a/docs/source/usage/operations/projections/lcc.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _lcc: - -******************************************************************************** -Lambert Conformal Conic -******************************************************************************** - -.. image:: ./images/lcc.png - :scale: 50% - :alt: Lambert Conformal Conic - diff --git a/docs/source/usage/operations/projections/lcca.rst b/docs/source/usage/operations/projections/lcca.rst deleted file mode 100644 index ca87e67e..00000000 --- a/docs/source/usage/operations/projections/lcca.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _lcca: - -******************************************************************************** -Lambert Conformal Conic Alternative -******************************************************************************** - -.. image:: ./images/lcca.png - :scale: 50% - :alt: Lambert Conformal Conic Alternative - diff --git a/docs/source/usage/operations/projections/leac.rst b/docs/source/usage/operations/projections/leac.rst deleted file mode 100644 index 2957798e..00000000 --- a/docs/source/usage/operations/projections/leac.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _leac: - -******************************************************************************** -Lambert Equal Area Conic -******************************************************************************** - -.. image:: ./images/leac.png - :scale: 50% - :alt: Lambert Equal Area Conic - diff --git a/docs/source/usage/operations/projections/lee_os.rst b/docs/source/usage/operations/projections/lee_os.rst deleted file mode 100644 index 711dc754..00000000 --- a/docs/source/usage/operations/projections/lee_os.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _lee_os: - -******************************************************************************** -Lee Oblated Stereographic -******************************************************************************** - -.. image:: ./images/lee_os.png - :scale: 50% - :alt: Lee Oblated Stereographic - diff --git a/docs/source/usage/operations/projections/loxim.rst b/docs/source/usage/operations/projections/loxim.rst deleted file mode 100644 index e50ba472..00000000 --- a/docs/source/usage/operations/projections/loxim.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _loxim: - -******************************************************************************** -Loximuthal -******************************************************************************** - -.. image:: ./images/loxim.png - :scale: 50% - :alt: Loximuthal - diff --git a/docs/source/usage/operations/projections/lsat.rst b/docs/source/usage/operations/projections/lsat.rst deleted file mode 100644 index fb64bdb2..00000000 --- a/docs/source/usage/operations/projections/lsat.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _lsat: - -******************************************************************************** -Space oblique for LANDSAT -******************************************************************************** - -.. image:: ./images/lsat.png - :scale: 50% - :alt: Space oblique for LANDSAT - diff --git a/docs/source/usage/operations/projections/mbt_fps.rst b/docs/source/usage/operations/projections/mbt_fps.rst deleted file mode 100644 index 55ebcf6c..00000000 --- a/docs/source/usage/operations/projections/mbt_fps.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _mbt_fps: - -******************************************************************************** -McBryde-Thomas Flat-Pole Sine (No. 2) -******************************************************************************** - -.. image:: ./images/mbt_fps.png - :scale: 50% - :alt: McBryde-Thomas Flat-Pole Sine (No. 2) - diff --git a/docs/source/usage/operations/projections/mbt_s.rst b/docs/source/usage/operations/projections/mbt_s.rst deleted file mode 100644 index 9a355ec8..00000000 --- a/docs/source/usage/operations/projections/mbt_s.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _mbt_s: - -******************************************************************************** -McBryde-Thomas Flat-Polar Sine (No. 1) -******************************************************************************** - -.. image:: ./images/mbt_s.png - :scale: 50% - :alt: McBryde-Thomas Flat-Polar Sine (No. 1) - diff --git a/docs/source/usage/operations/projections/mbtfpp.rst b/docs/source/usage/operations/projections/mbtfpp.rst deleted file mode 100644 index 9be309d9..00000000 --- a/docs/source/usage/operations/projections/mbtfpp.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _mbtfpp: - -******************************************************************************** -McBride-Thomas Flat-Polar Parabolic -******************************************************************************** - -.. image:: ./images/mbtfpp.png - :scale: 50% - :alt: McBride-Thomas Flat-Polar Parabolic - diff --git a/docs/source/usage/operations/projections/mbtfpq.rst b/docs/source/usage/operations/projections/mbtfpq.rst deleted file mode 100644 index 295e814d..00000000 --- a/docs/source/usage/operations/projections/mbtfpq.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _mbtfpq: - -******************************************************************************** -McBryde-Thomas Flat-Polar Quartic -******************************************************************************** - -.. image:: ./images/mbtfpq.png - :scale: 50% - :alt: McBryde-Thomas Flat-Polar Quartic - diff --git a/docs/source/usage/operations/projections/mbtfps.rst b/docs/source/usage/operations/projections/mbtfps.rst deleted file mode 100644 index b9365361..00000000 --- a/docs/source/usage/operations/projections/mbtfps.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _mbtfps: - -******************************************************************************** -McBryde-Thomas Flat-Polar Sinusoidal -******************************************************************************** - -.. image:: ./images/mbtfps.png - :scale: 50% - :alt: McBryde-Thomas Flat-Polar Sinusoidal - diff --git a/docs/source/usage/operations/projections/merc.rst b/docs/source/usage/operations/projections/merc.rst deleted file mode 100644 index 8895abc8..00000000 --- a/docs/source/usage/operations/projections/merc.rst +++ /dev/null @@ -1,140 +0,0 @@ -.. _merc: - -******************************************************************************** -Mercator -******************************************************************************** - -The Mercator projection is a cylindrical map projection that origins from the 15th -century. It is widely recognized as the first regularly used map projection. -The projection is conformal which makes it suitable for navigational purposes. - - -+---------------------+----------------------------------------------------------+ -| **Classification** | Conformal cylindrical | -+---------------------+----------------------------------------------------------+ -| **Available forms** | Forward and inverse, spherical and elliptical projection | -+---------------------+----------------------------------------------------------+ -| **Defined area** | Global, but best used near the equator | -+---------------------+----------------------------------------------------------+ -| **Implemented by** | Gerald I. Evenden | -+---------------------+----------------------------------------------------------+ -| **Options** | -+---------------------+----------------------------------------------------------+ -| `+lat_ts` | Latitude of true scale. Defaults to 0.0 | -+---------------------+----------------------------------------------------------+ -| `+k_0` | Scaling factor. Defaults to 1.0 | -+---------------------+----------------------------------------------------------+ - - - -.. image:: ./images/merc.png - :scale: 50% - :alt: Mercator - - -Usage -######## - -Applications should be limited to equatorial regions, but is frequently -used for navigational charts with latitude of true scale (``+lat_ts``) specified within -or near chart's boundaries. -Often inappropriately used for world maps since the regions near the poles -cannot be shown [Evenden1995]_. - - -Example using latitude of true scale:: - - $ echo 56.35 12.32 | proj +proj=merc +lat_ts=56.5 - 3470306.37 759599.90 - -Example using scaling factor:: - - echo 56.35 12.32 | proj +proj=merc +k_0=2 - 12545706.61 2746073.80 - - -Note that ``+lat_ts`` and ``+k_0`` are mutually exclusive. -If used together, ``+lat_ts`` takes precedence over ``+k_0``. - -Mathematical definition -####################### - -The formulas describing the Mercator projection are all taken from G. Evenden's libproj manuals [Evenden2005]_. - -Spherical form -************** -For the spherical form of the projection we introduce the scaling factor: - -.. math:: - - k_0 = \cos \phi_{ts} - -Forward projection -================== - -.. math:: - - x = k_0 \lambda - -.. math:: - - y = k_0 \ln \left[ \tan \left(\frac{\pi}{4} + \frac{\phi}{2} \right) \right] - - -Inverse projection -================== - -.. math:: - - \lambda = \frac{x}{k_0} - -.. math:: - - \phi = \frac{\pi}{2} - 2 \arctan \left[ e^{-y/k_0} \right] - - -Elliptical form -*************** - -For the elliptical form of the projection we introduce the scaling factor: - -.. math:: - - k_0 = m\left( \phi_ts \right) - -where :math:`m\left(\phi\right)` is the parallel radius at latitude :math:`\phi`. - -We also use the Isometric Latitude kernel function :math:`t()`. - -.. note:: - m() and t() should be described properly on a separate page about the theory of projections on the ellipsoid. - -Forward projection -================== -.. math:: - - x = k_0 \lambda - -.. math:: - - y = k_0 \ln t \left( \phi \right) - - -Inverse projection -================== - -.. math:: - - \lambda = \frac{x}{k_0} - -.. math:: - - \phi = t^{-1}\left[ e^{ -y/k_0 } \right] - -Further reading -############### - -#. `Wikipedia `_ -#. `Wolfram Mathworld `_ - - diff --git a/docs/source/usage/operations/projections/mil_os.rst b/docs/source/usage/operations/projections/mil_os.rst deleted file mode 100644 index 5547e43c..00000000 --- a/docs/source/usage/operations/projections/mil_os.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _mil_os: - -******************************************************************************** -Miller Oblated Stereographic -******************************************************************************** - -.. image:: ./images/mil_os.png - :scale: 50% - :alt: Miller Oblated Stereographic - diff --git a/docs/source/usage/operations/projections/mill.rst b/docs/source/usage/operations/projections/mill.rst deleted file mode 100644 index eb9c2092..00000000 --- a/docs/source/usage/operations/projections/mill.rst +++ /dev/null @@ -1,72 +0,0 @@ -.. _mill: - -******************************************************************************** -Miller Cylindrical -******************************************************************************** - -The Miller cylindrical projection is a modified Mercator projection, proposed by Osborn Maitland Miller in 1942. -The latitude is scaled by a factor of :math:`\frac{4}{5}`, projected according to Mercator, and then the result is multiplied by :math:`\frac{5}{4}` to retain scale along the equator. - -+---------------------+--------------------------------------------------------------------------------+ -| **Classification** | Neither conformal nor equal area cylindrical | -+---------------------+--------------------------------------------------------------------------------+ -| **Available forms** | Forward and inverse spherical | -+---------------------+--------------------------------------------------------------------------------+ -| **Defined area** | Global, but best used near the equator | -+---------------------+--------------------------------------------------------------------------------+ -| **Implemented by** | Gerald I. Evenden | -+---------------------+--------------------------------------------------------------------------------+ -| **Options** | -+---------------------+--------------------------------------------------------------------------------+ -| `+lat_0` | Latitude of origin (Default to 0) | -+---------------------+--------------------------------------------------------------------------------+ - -.. image:: ./images/mill.png - :scale: 50% - :alt: Miller Cylindrical - -Usage -######## - -The Miller Cylindrical projection is used for world maps and in several atlases, -including the National Atlas of the United States (USGS, 1970, p. 330-331) [Snyder1987]_. - -Example using Central meridian 90°W:: - - $ echo -100 35 | proj +proj=mill +lon_0=90w - -1113194.91 4061217.24 - -Mathematical definition -####################### - -The formulas describing the Miller projection are all taken from Snyder's manuals [Snyder1987]_. - - -Forward projection -================== - -.. math:: - - x = \lambda - -.. math:: - - y = 1.25 * \ln \left[ \tan \left(\frac{\pi}{4} + 0.4 * \phi \right) \right] - - -Inverse projection -================== - -.. math:: - - \lambda = x - -.. math:: - - \phi = 2.5 * ( \arctan \left[ e^{0.8 * y} \right] - \frac{\pi}{4} ) - -Further reading -############### - -#. `Wikipedia `_ - diff --git a/docs/source/usage/operations/projections/moll.rst b/docs/source/usage/operations/projections/moll.rst deleted file mode 100644 index 1bd3d005..00000000 --- a/docs/source/usage/operations/projections/moll.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _moll: - -******************************************************************************** -Mollweide -******************************************************************************** - -.. image:: ./images/moll.png - :scale: 50% - :alt: Mollweide - diff --git a/docs/source/usage/operations/projections/murd1.rst b/docs/source/usage/operations/projections/murd1.rst deleted file mode 100644 index 71cbf155..00000000 --- a/docs/source/usage/operations/projections/murd1.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _murd1: - -******************************************************************************** -Murdoch I -******************************************************************************** - -.. image:: ./images/murd1.png - :scale: 50% - :alt: Murdoch I - diff --git a/docs/source/usage/operations/projections/murd2.rst b/docs/source/usage/operations/projections/murd2.rst deleted file mode 100644 index b55cde35..00000000 --- a/docs/source/usage/operations/projections/murd2.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _murd2: - -******************************************************************************** -Murdoch II -******************************************************************************** - -.. image:: ./images/murd2.png - :scale: 50% - :alt: Murdoch II - diff --git a/docs/source/usage/operations/projections/murd3.rst b/docs/source/usage/operations/projections/murd3.rst deleted file mode 100644 index 70cc9276..00000000 --- a/docs/source/usage/operations/projections/murd3.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _murd3: - -******************************************************************************** -Murdoch III -******************************************************************************** - -.. image:: ./images/murd3.png - :scale: 50% - :alt: Murdoch III - diff --git a/docs/source/usage/operations/projections/natearth.rst b/docs/source/usage/operations/projections/natearth.rst deleted file mode 100644 index 57dd96db..00000000 --- a/docs/source/usage/operations/projections/natearth.rst +++ /dev/null @@ -1,47 +0,0 @@ -.. _natearth: - -******************************************************************************** -Natural Earth -******************************************************************************** -+---------------------+--------------------------------------------------------+ -| **Classification** | Pseudo cylindrical | -+---------------------+--------------------------------------------------------+ -| **Available forms** | Forward and inverse, spherical projection | -+---------------------+--------------------------------------------------------+ -| **Defined area** | Global | -+---------------------+--------------------------------------------------------+ -| **Implemented by** | Bernhard Jenny | -+---------------------+--------------------------------------------------------+ -| **Options** | -+---------------------+--------------------------------------------------------+ -| `No special options for this projection` | -+---------------------+--------------------------------------------------------+ - -.. image:: ./images/natearth.png - :scale: 50% - :alt: Natural Earth - - -The Natural Earth projection is intended for making world maps. A distinguishing trait -is its slightly rounded corners fashioned to emulate the spherical shape of Earth. -The meridians (except for the central meridian) bend acutely inward as they approach -the pole lines, giving the projection a hint of three-dimensionality. This bending -also suggests that the meridians converge at the poles instead of truncating at the -top and bottom edges. The distortion characteristics of the Natural Earth projection -compare favorably to other world map projections. - - -Usage -############################################################################### - -The Natural Earth projection has no special options so usage is simple. Here is -an example of an inverse projection on a sphere with a radius of 7500 m:: - - $ echo 3500 -8000 | proj -I +proj=natearth +a=7500 - 37d54'6.091"E 61d23'4.582"S - - -Further reading -################################################################################ - -#. `Wikipedia `_ diff --git a/docs/source/usage/operations/projections/nell.rst b/docs/source/usage/operations/projections/nell.rst deleted file mode 100644 index c6a3771c..00000000 --- a/docs/source/usage/operations/projections/nell.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _nell: - -******************************************************************************** -Nell -******************************************************************************** - -.. image:: ./images/nell.png - :scale: 50% - :alt: Nell - diff --git a/docs/source/usage/operations/projections/nell_h.rst b/docs/source/usage/operations/projections/nell_h.rst deleted file mode 100644 index 6a3b26ba..00000000 --- a/docs/source/usage/operations/projections/nell_h.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _nell_h: - -******************************************************************************** -Nell-Hammer -******************************************************************************** - -.. image:: ./images/nell_h.png - :scale: 50% - :alt: Nell-Hammer - diff --git a/docs/source/usage/operations/projections/nicol.rst b/docs/source/usage/operations/projections/nicol.rst deleted file mode 100644 index 995cedb5..00000000 --- a/docs/source/usage/operations/projections/nicol.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _nicol: - -******************************************************************************** -Nicolosi Globular -******************************************************************************** - -.. image:: ./images/nicol.png - :scale: 50% - :alt: Nicolosi Globular - diff --git a/docs/source/usage/operations/projections/nsper.rst b/docs/source/usage/operations/projections/nsper.rst deleted file mode 100644 index 4a8651fc..00000000 --- a/docs/source/usage/operations/projections/nsper.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _nsper: - -******************************************************************************** -Near-sided perspective -******************************************************************************** - -.. image:: ./images/nsper.png - :scale: 50% - :alt: Near-sided perspective - diff --git a/docs/source/usage/operations/projections/nzmg.rst b/docs/source/usage/operations/projections/nzmg.rst deleted file mode 100644 index 926655d8..00000000 --- a/docs/source/usage/operations/projections/nzmg.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _nzmg: - -******************************************************************************** -New Zealand Map Grid -******************************************************************************** - -.. image:: ./images/nzmg.png - :scale: 50% - :alt: New Zealand Map Grid - diff --git a/docs/source/usage/operations/projections/ob_tran.rst b/docs/source/usage/operations/projections/ob_tran.rst deleted file mode 100644 index 3c996336..00000000 --- a/docs/source/usage/operations/projections/ob_tran.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _ob_tran: - -******************************************************************************** -General Oblique Transformation -******************************************************************************** - -.. image:: ./images/ob_tran.png - :scale: 50% - :alt: General Oblique Transformation - diff --git a/docs/source/usage/operations/projections/ocea.rst b/docs/source/usage/operations/projections/ocea.rst deleted file mode 100644 index 40005d9e..00000000 --- a/docs/source/usage/operations/projections/ocea.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _ocea: - -******************************************************************************** -Oblique Cylindrical Equal Area -******************************************************************************** - -.. image:: ./images/ocea.png - :scale: 50% - :alt: Oblique Cylindrical Equal Area - diff --git a/docs/source/usage/operations/projections/oea.rst b/docs/source/usage/operations/projections/oea.rst deleted file mode 100644 index 379dc157..00000000 --- a/docs/source/usage/operations/projections/oea.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _oea: - -******************************************************************************** -Oblated Equal Area -******************************************************************************** - -.. image:: ./images/oea.png - :scale: 50% - :alt: Oblated Equal Area - diff --git a/docs/source/usage/operations/projections/omerc.rst b/docs/source/usage/operations/projections/omerc.rst deleted file mode 100644 index 114b9fa3..00000000 --- a/docs/source/usage/operations/projections/omerc.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _omerc: - -******************************************************************************** -Oblique Mercator -******************************************************************************** - -.. image:: ./images/omerc.png - :scale: 50% - :alt: Oblique Mercator - diff --git a/docs/source/usage/operations/projections/ortel.rst b/docs/source/usage/operations/projections/ortel.rst deleted file mode 100644 index 03f132ef..00000000 --- a/docs/source/usage/operations/projections/ortel.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _ortel: - -******************************************************************************** -Ortelius Oval -******************************************************************************** - -.. image:: ./images/ortel.png - :scale: 50% - :alt: Ortelius Oval - diff --git a/docs/source/usage/operations/projections/ortho.rst b/docs/source/usage/operations/projections/ortho.rst deleted file mode 100644 index 131dbfc7..00000000 --- a/docs/source/usage/operations/projections/ortho.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _ortho: - -******************************************************************************** -Orthographic -******************************************************************************** - -.. image:: ./images/ortho.png - :scale: 50% - :alt: Orthographic - diff --git a/docs/source/usage/operations/projections/pconic.rst b/docs/source/usage/operations/projections/pconic.rst deleted file mode 100644 index 6bc0018e..00000000 --- a/docs/source/usage/operations/projections/pconic.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _pconic: - -******************************************************************************** -Perspective Conic -******************************************************************************** - -.. image:: ./images/pconic.png - :scale: 50% - :alt: Perspective Conic - diff --git a/docs/source/usage/operations/projections/poly.rst b/docs/source/usage/operations/projections/poly.rst deleted file mode 100644 index e252feb5..00000000 --- a/docs/source/usage/operations/projections/poly.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _poly: - -******************************************************************************** -Polyconic (American) -******************************************************************************** - -.. image:: ./images/poly.png - :scale: 50% - :alt: Polyconic (American) - diff --git a/docs/source/usage/operations/projections/putp1.rst b/docs/source/usage/operations/projections/putp1.rst deleted file mode 100644 index 68971a46..00000000 --- a/docs/source/usage/operations/projections/putp1.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _putp1: - -******************************************************************************** -Putnins P1 -******************************************************************************** - -.. image:: ./images/putp1.png - :scale: 50% - :alt: Putnins P1 - diff --git a/docs/source/usage/operations/projections/putp2.rst b/docs/source/usage/operations/projections/putp2.rst deleted file mode 100644 index 01ea8073..00000000 --- a/docs/source/usage/operations/projections/putp2.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _putp2: - -******************************************************************************** -Putnins P2 -******************************************************************************** - -.. image:: ./images/putp2.png - :scale: 50% - :alt: Putnins P2 - diff --git a/docs/source/usage/operations/projections/putp3.rst b/docs/source/usage/operations/projections/putp3.rst deleted file mode 100644 index 3aa6b9e6..00000000 --- a/docs/source/usage/operations/projections/putp3.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _putp3: - -******************************************************************************** -Putnins P3 -******************************************************************************** - -.. image:: ./images/putp3.png - :scale: 50% - :alt: Putnins P3 - diff --git a/docs/source/usage/operations/projections/putp3p.rst b/docs/source/usage/operations/projections/putp3p.rst deleted file mode 100644 index 5b87512e..00000000 --- a/docs/source/usage/operations/projections/putp3p.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _putp3p: - -******************************************************************************** -Putnins P3' -******************************************************************************** - -.. image:: ./images/putp3p.png - :scale: 50% - :alt: Putnins P3' - diff --git a/docs/source/usage/operations/projections/putp4p.rst b/docs/source/usage/operations/projections/putp4p.rst deleted file mode 100644 index b211ad9b..00000000 --- a/docs/source/usage/operations/projections/putp4p.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _putp4p: - -******************************************************************************** -Putnins P4' -******************************************************************************** - -.. image:: ./images/putp4p.png - :scale: 50% - :alt: Putnins P4' - diff --git a/docs/source/usage/operations/projections/putp5.rst b/docs/source/usage/operations/projections/putp5.rst deleted file mode 100644 index 5b60a961..00000000 --- a/docs/source/usage/operations/projections/putp5.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _putp5: - -******************************************************************************** -Putnins P5 -******************************************************************************** - -.. image:: ./images/putp5.png - :scale: 50% - :alt: Putnins P5 - diff --git a/docs/source/usage/operations/projections/putp5p.rst b/docs/source/usage/operations/projections/putp5p.rst deleted file mode 100644 index f586b889..00000000 --- a/docs/source/usage/operations/projections/putp5p.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _putp5p: - -******************************************************************************** -Putnins P5' -******************************************************************************** - -.. image:: ./images/putp5p.png - :scale: 50% - :alt: Putnins P5' - diff --git a/docs/source/usage/operations/projections/putp6.rst b/docs/source/usage/operations/projections/putp6.rst deleted file mode 100644 index 94683ace..00000000 --- a/docs/source/usage/operations/projections/putp6.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _putp6: - -******************************************************************************** -Putnins P6 -******************************************************************************** - -.. image:: ./images/putp6.png - :scale: 50% - :alt: Putnins P6 - diff --git a/docs/source/usage/operations/projections/putp6p.rst b/docs/source/usage/operations/projections/putp6p.rst deleted file mode 100644 index 8c3add71..00000000 --- a/docs/source/usage/operations/projections/putp6p.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _putp6p: - -******************************************************************************** -Putnins P6' -******************************************************************************** - -.. image:: ./images/putp6p.png - :scale: 50% - :alt: Putnins P6' - diff --git a/docs/source/usage/operations/projections/qsc.rst b/docs/source/usage/operations/projections/qsc.rst deleted file mode 100644 index e3af2cee..00000000 --- a/docs/source/usage/operations/projections/qsc.rst +++ /dev/null @@ -1,158 +0,0 @@ -.. _qsc: - -******************************************************************************** -Quadrilateralized Spherical Cube -******************************************************************************** - -+---------------------+----------------------------------------------------------+ -| **Classification** | Azimuthal | -+---------------------+----------------------------------------------------------+ -| **Available forms** | Forward and inverse, elliptical projection | -+---------------------+----------------------------------------------------------+ -| **Defined area** | Global | -+---------------------+----------------------------------------------------------+ -| **Implemented by** | Martin Lambers | -+---------------------+----------------------------------------------------------+ -| **Options** | -+---------------------+----------------------------------------------------------+ -| `+lat_0` | Latitude (in degrees) of the view position. | -+---------------------+----------------------------------------------------------+ -| `+lon_0` | Longitude (in degrees) of the view position. | -+---------------------+----------------------------------------------------------+ - -The purpose of the Quadrilateralized Spherical Cube (QSC) projection is to project -a sphere surface onto the six sides of a cube: - -.. image:: ../../../../images/qsc_concept.jpg - :scale: 50% - :align: center - :alt: Quadrilateralized Spherical Cube - -For this purpose, other alternatives can be used, notably :ref:`gnom` or -:ref:`healpix`. However, QSC projection has the following favorable properties: - -It is an equal-area projection, and at the same time introduces only limited angular -distortions. It treats all cube sides equally, i.e. it does not use different -projections for polar areas and equatorial areas. These properties make QSC -projection a good choice for planetary-scale terrain rendering. Map data can be -organized in quadtree structures for each cube side. See [LambersKolb2012]_ for an example. - -The QSC projection was introduced by [ONeilLaubscher1976]_, -building on previous work by [ChanONeil1975]_. For clarity: The -earlier QSC variant described in [ChanONeil1975]_ became known as the COBE QSC since it -was used by the NASA Cosmic Background Explorer (COBE) project; it is an approximately -equal-area projection and is not the same as the QSC projection. - -See also [CalabrettaGreisen2002]_ Sec. 5.6.2 and 5.6.3 for a description of both and -some analysis. - -In this implementation, the QSC projection projects onto one side of a circumscribed -cube. The cube side is selected by choosing one of the following six projection centers: - -+-------------------------+--------------------+ -| ``+lat_0=0 +lon_0=0`` | front cube side | -+-------------------------+--------------------+ -| ``+lat_0=0 +lon_0=90`` | right cube side | -+-------------------------+--------------------+ -| ``+lat_0=0 +lon_0=180`` | back cube side | -+-------------------------+--------------------+ -| ``+lat_0=0 +lon_0=-90`` | left cube side | -+-------------------------+--------------------+ -| ``+lat_0=90`` | top cube side | -+-------------------------+--------------------+ -| ``+lat_0=-90`` | bottom cube side | -+-------------------------+--------------------+ - -Furthermore, this implementation allows the projection to be applied to ellipsoids. -A preceding shift to a sphere is performed automatically; see [LambersKolb2012]_ for details. - - -Usage -############################################################################### - -The following example uses QSC projection via GDAL to create the six cube side -maps from a world map for the WGS84 ellipsoid:: - - gdalwarp -t_srs "+wktext +proj=qsc +units=m +ellps=WGS84 +lat_0=0 +lon_0=0" \ - -wo SOURCE_EXTRA=100 -wo SAMPLE_GRID=YES -te -6378137 -6378137 6378137 6378137 \ - worldmap.tiff frontside.tiff - - gdalwarp -t_srs "+wktext +proj=qsc +units=m +ellps=WGS84 +lat_0=0 +lon_0=90" \ - -wo SOURCE_EXTRA=100 -wo SAMPLE_GRID=YES -te -6378137 -6378137 6378137 6378137 \ - worldmap.tiff rightside.tiff - - gdalwarp -t_srs "+wktext +proj=qsc +units=m +ellps=WGS84 +lat_0=0 +lon_0=180" \ - -wo SOURCE_EXTRA=100 -wo SAMPLE_GRID=YES -te -6378137 -6378137 6378137 6378137 \ - worldmap.tiff backside.tiff - - gdalwarp -t_srs "+wktext +proj=qsc +units=m +ellps=WGS84 +lat_0=0 +lon_0=-90" \ - -wo SOURCE_EXTRA=100 -wo SAMPLE_GRID=YES -te -6378137 -6378137 6378137 6378137 \ - worldmap.tiff leftside.tiff - - gdalwarp -t_srs "+wktext +proj=qsc +units=m +ellps=WGS84 +lat_0=90 +lon_0=0" \ - -wo SOURCE_EXTRA=100 -wo SAMPLE_GRID=YES -te -6378137 -6378137 6378137 6378137 \ - worldmap.tiff topside.tiff - - gdalwarp -t_srs "+wktext +proj=qsc +units=m +ellps=WGS84 +lat_0=-90 +lon_0=0" \ - -wo SOURCE_EXTRA=100 -wo SAMPLE_GRID=YES -te -6378137 -6378137 6378137 6378137 \ - worldmap.tiff bottomside.tiff - - -Explanation: - -* QSC projection is selected with ``+wktext +proj=qsc``. -* The WGS84 ellipsoid is specified with ``+ellps=WGS84``. -* The cube side is selected with ``+lat_0=... +lon_0=...``. -* The ``-wo`` options are necessary for GDAL to avoid holes in the output maps. -* The ``-te`` option limits the extends of the output map to the major axis diameter - (from -radius to +radius in both x and y direction). These are the dimensions of one side - of the circumscribing cube. - - -The resulting images can be laid out in a grid like below. - - -.. |topside| image:: ../../../../images/qsc_topside.jpg - :scale: 50% - :align: middle - :alt: Top side - -.. |leftside| image:: ../../../../images/qsc_leftside.jpg - :scale: 50% - :align: middle - :alt: Left side - -.. |frontside| image:: ../../../../images/qsc_frontside.jpg - :scale: 50% - :align: middle - :alt: Front side - -.. |rightside| image:: ../../../../images/qsc_rightside.jpg - :scale: 50% - :align: middle - :alt: Right side - -.. |backside| image:: ../../../../images/qsc_backside.jpg - :scale: 50% - :align: middle - :alt: Back side - -.. |bottomside| image:: ../../../../images/qsc_bottomside.jpg - :scale: 50% - :align: middle - :alt: Bottom side - - -+------------+--------------+-------------+------------+ -| | |topside| | | | -+------------+--------------+-------------+------------+ -| |leftside| | |frontside| | |rightside| | |backside| | -+------------+--------------+-------------+------------+ -| | |bottomside| | | | -+------------+--------------+-------------+------------+ - -Further reading -################################################################################ - -#. `Wikipedia `_ -#. `NASA `_ diff --git a/docs/source/usage/operations/projections/qua_aut.rst b/docs/source/usage/operations/projections/qua_aut.rst deleted file mode 100644 index d3a0aece..00000000 --- a/docs/source/usage/operations/projections/qua_aut.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _qua_aut: - -******************************************************************************** -Quartic Authalic -******************************************************************************** - -.. image:: ./images/qua_aut.png - :scale: 50% - :alt: Quartic Authalic - diff --git a/docs/source/usage/operations/projections/rhealpix.rst b/docs/source/usage/operations/projections/rhealpix.rst deleted file mode 100644 index b8ed4f5f..00000000 --- a/docs/source/usage/operations/projections/rhealpix.rst +++ /dev/null @@ -1,51 +0,0 @@ -.. _rhealpix: - -******************************************************************************** -rHEALPix -******************************************************************************** -+---------------------+----------------------------------------------------------+ -| **Classification** | Mixed | -+---------------------+----------------------------------------------------------+ -| **Available forms** | Forward and inverse, spherical and elliptical projection | -+---------------------+----------------------------------------------------------+ -| **Defined area** | Global | -+---------------------+----------------------------------------------------------+ -| **Implemented by** | Alex Raichev and Michael Speth | -+---------------------+----------------------------------------------------------+ -| **Options** | -+---------------------+----------------------------------------------------------+ -| `+north_square` | Position of the north polar square. | -| | Valid inputs are 0--3. Defaults to 0. | -+---------------------+----------------------------------------------------------+ -| `+south_square` | Position of the south polar square. | -| | Valid inputs are 0--3. Defaults to 0. | -+---------------------+----------------------------------------------------------+ - -.. image:: ../../../../images/rhealpix.png - :scale: 75% - :alt: rHEALPix - -rHEALPix is a projection based on the HEALPix projection. The implementation of -rHEALPix uses the HEALPix projection. The rHEALPix combines the peaks of the -HEALPix into a square. The square's position can be translated and rotated across -the x-axis which is a novel approach for the rHEALPix projection. The initial -intention of using rHEALPix in the Spatial Computation Engine Science Collaboration -Environment (SCENZGrid). - -Usage -############################################################################### - -To run a rHEALPix projection on a WGS84 ellipsoidal model, use the following -command:: - - proj +proj=rhealpix -f '%.2f' +ellps=WGS84 +south_square=0 +north_square=2 -E << EOF - > 55 12 - > EOF - 55 12 6115727.86 1553840.13 - - -Further reading -################################################################################ - -#. `NASA `_ -#. `Wikipedia `_ diff --git a/docs/source/usage/operations/projections/robin.rst b/docs/source/usage/operations/projections/robin.rst deleted file mode 100644 index 3e58be46..00000000 --- a/docs/source/usage/operations/projections/robin.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _robin: - -******************************************************************************** -Robinson -******************************************************************************** - -.. image:: ./images/robin.png - :scale: 50% - :alt: Robinson - diff --git a/docs/source/usage/operations/projections/rouss.rst b/docs/source/usage/operations/projections/rouss.rst deleted file mode 100644 index e27fb1cf..00000000 --- a/docs/source/usage/operations/projections/rouss.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _rouss: - -******************************************************************************** -Roussilhe Stereographic -******************************************************************************** - -.. image:: ./images/rouss.png - :scale: 50% - :alt: Roussilhe Stereographic - diff --git a/docs/source/usage/operations/projections/rpoly.rst b/docs/source/usage/operations/projections/rpoly.rst deleted file mode 100644 index 80e0d640..00000000 --- a/docs/source/usage/operations/projections/rpoly.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _rpoly: - -******************************************************************************** -Rectangular Polyconic -******************************************************************************** - -.. image:: ./images/rpoly.png - :scale: 50% - :alt: Rectangular Polyconic - diff --git a/docs/source/usage/operations/projections/sinu.rst b/docs/source/usage/operations/projections/sinu.rst deleted file mode 100644 index a7ebd232..00000000 --- a/docs/source/usage/operations/projections/sinu.rst +++ /dev/null @@ -1,24 +0,0 @@ -.. _sinu: - -******************************************************************************** -Sinusoidal (Sanson-Flamsteed) -******************************************************************************** - -.. image:: ./images/sinu.png - :scale: 50% - :alt: Sinusoidal (Sanson-Flamsteed) - -MacBryde and Thomas developed generalized formulas for sever of the -pseudocylindricals with sinusoidal meridians: - -.. math:: - - x = C\lambda(m+cos\theta) / ( m + 1) - -.. math:: - y = C\theta - -.. math:: - - C = \sqrt { (m + 1 ) / n } - diff --git a/docs/source/usage/operations/projections/somerc.rst b/docs/source/usage/operations/projections/somerc.rst deleted file mode 100644 index c572622b..00000000 --- a/docs/source/usage/operations/projections/somerc.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _somerc: - -******************************************************************************** -Swiss. Obl. Mercator -******************************************************************************** - -.. image:: ./images/somerc.png - :scale: 50% - :alt: Swiss. Obl. Mercator - diff --git a/docs/source/usage/operations/projections/stere.rst b/docs/source/usage/operations/projections/stere.rst deleted file mode 100644 index d4958ec9..00000000 --- a/docs/source/usage/operations/projections/stere.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _stere: - -******************************************************************************** -Stereographic -******************************************************************************** - -.. image:: ./images/stere.png - :scale: 50% - :alt: Stereographic - diff --git a/docs/source/usage/operations/projections/sterea.rst b/docs/source/usage/operations/projections/sterea.rst deleted file mode 100644 index 4f2f8727..00000000 --- a/docs/source/usage/operations/projections/sterea.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _sterea: - -******************************************************************************** -Oblique Stereographic Alternative -******************************************************************************** - -.. image:: ./images/sterea.png - :scale: 50% - :alt: Oblique Stereographic Alternative - diff --git a/docs/source/usage/operations/projections/tcc.rst b/docs/source/usage/operations/projections/tcc.rst deleted file mode 100644 index 586dd3b8..00000000 --- a/docs/source/usage/operations/projections/tcc.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _tcc: - -******************************************************************************** -Transverse Central Cylindrical -******************************************************************************** - -.. image:: ./images/tcc.png - :scale: 50% - :alt: Transverse Central Cylindrical - diff --git a/docs/source/usage/operations/projections/tcea.rst b/docs/source/usage/operations/projections/tcea.rst deleted file mode 100644 index cf5549a3..00000000 --- a/docs/source/usage/operations/projections/tcea.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _tcea: - -******************************************************************************** -Transverse Cylindrical Equal Area -******************************************************************************** - -.. image:: ./images/tcea.png - :scale: 50% - :alt: Transverse Cylindrical Equal Area - diff --git a/docs/source/usage/operations/projections/tissot.rst b/docs/source/usage/operations/projections/tissot.rst deleted file mode 100644 index 7ec1a741..00000000 --- a/docs/source/usage/operations/projections/tissot.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _tissot: - -******************************************************************************** -Tissot -******************************************************************************** - -.. image:: ./images/tissot.png - :scale: 50% - :alt: Tissot - diff --git a/docs/source/usage/operations/projections/tmerc.rst b/docs/source/usage/operations/projections/tmerc.rst deleted file mode 100644 index 1fc0cd7e..00000000 --- a/docs/source/usage/operations/projections/tmerc.rst +++ /dev/null @@ -1,197 +0,0 @@ -.. _tmerc: - -******************************************************************************** -Transverse Mercator -******************************************************************************** - -The transverse Mercator projection in its various forms is the most widely used projected coordinate system for world topographical and offshore mapping. - -+---------------------+--------------------------------------------------------------------------------+ -| **Classification** | Transverse and oblique cylindrical | -+---------------------+--------------------------------------------------------------------------------+ -| **Available forms** | Forward and inverse, Spherical and Elliptical | -+---------------------+--------------------------------------------------------------------------------+ -| **Defined area** | Global, but reasonably accurate only within 15 degrees of the central meridian | -+---------------------+--------------------------------------------------------------------------------+ -| **Implemented by** | Gerald I. Evenden | -+---------------------+--------------------------------------------------------------------------------+ -| **Options** | -+---------------------+--------------------------------------------------------------------------------+ -| `+lat_0` | Latitude of origin (Default to 0) | -+---------------------+--------------------------------------------------------------------------------+ -| `+k0` | Scale factor at natural origin (Default to 1) | -+---------------------+--------------------------------------------------------------------------------+ - - -.. image:: ./images/tmerc.png - :scale: 50% - :alt: Transverse Mercator - -Usage -##### - - -Prior to the development of the Universal Transverse Mercator coordinate system, several European nations demonstrated the utility of grid-based conformal maps by mapping their territory during the interwar period. -Calculating the distance between two points on these maps could be performed more easily in the field (using the Pythagorean theorem) than was possible using the trigonometric formulas required under the graticule-based system of latitude and longitude. -In the post-war years, these concepts were extended into the Universal Transverse Mercator/Universal Polar Stereographic (UTM/UPS) coordinate system, which is a global (or universal) system of grid-based maps. - -The following table gives special cases of the Transverse Mercator projection. - -+-------------------------------------+-----------------------------------------------------+--------------------------------+------------------------------------------+--------------+ -| Projection Name | Areas | Central meridian | Zone width | Scale Factor | -+-------------------------------------+-----------------------------------------------------+--------------------------------+------------------------------------------+--------------+ -| Transverse Mercator | World wide | Various | less than 6° | Various | -+-------------------------------------+-----------------------------------------------------+--------------------------------+------------------------------------------+--------------+ -| Transverse Mercator south oriented | Southern Africa | 2° intervals E of 11°E | 2° | 1.000 | -+-------------------------------------+-----------------------------------------------------+--------------------------------+------------------------------------------+--------------+ -| UTM North hemisphere | World wide equator to 84°N | 6° intervals E & W of 3° E & W | Always 6° | 0.9996 | -+-------------------------------------+-----------------------------------------------------+--------------------------------+------------------------------------------+--------------+ -| UTM South hemisphere | World wide north of 80°S to equator | 6° intervals E & W of 3° E & W | Always 6° | 0.9996 | -+-------------------------------------+-----------------------------------------------------+--------------------------------+------------------------------------------+--------------+ -| Gauss-Kruger | Former USSR, Yugoslavia, Germany, S. America, China | Various, according to area | Usually less than 6°, often less than 4° | 1.0000 | -+-------------------------------------+-----------------------------------------------------+--------------------------------+------------------------------------------+--------------+ -| Gauss Boaga | Italy | Various, according to area | 6° | 0.9996 | -+-------------------------------------+-----------------------------------------------------+--------------------------------+------------------------------------------+--------------+ - - - -Example using Gauss-Kruger on Germany area (aka EPSG:31467) :: - - $ echo 9 51 | proj +proj=tmerc +lat_0=0 +lon_0=9 +k=1 +x_0=3500000 +y_0=0 +ellps=bessel +datum=potsdam +units=m +no_defs - 3500000.00 5651505.56 - -Example using Gauss Boaga on Italy area (EPSG:3004) :: - - $ echo 15 42 | proj +proj=tmerc +lat_0=0 +lon_0=15 +k=0.9996 +x_0=2520000 +y_0=0 +ellps=intl +units=m +no_defs - 2520000.00 4649858.60 - -Mathematical definition -####################### - -The formulas describing the Transverse Mercator are all taken from Evenden's [Evenden2005]_. - -:math:`\phi_0` is the latitude of origin that match the center of the map. It can be set with ``+lat_0``. - -:math:`k_0` is the scale factor at the natural origin (on the central meridian). It can be set with ``+k_0``. - -:math:`M(\phi)` is the meridional distance. - -Spherical form -************** - -Forward projection -================== - -.. math:: - - B = \cos \phi \sin \lambda - -.. math:: - - x = \frac{k_0}{2} \ln(\frac{1+B}{1-B}) - -.. math:: - - y = k_0 ( \arctan(\frac{\tan(\phi)}{\cos \lambda}) - \phi_0) - - -Inverse projection -================== - -.. math:: - - D = \frac{y}{k_0} + \phi_0 - -.. math:: - - x' = \frac{x}{k_0} - -.. math:: - - \phi = \arcsin(\frac{\sin D}{\cosh x'}) - -.. math:: - - \lambda = \arctan(\frac{\sinh x'}{\cos D}) - - -Elliptical form -*************** - -Forward projection -================== - -.. math:: - - N = \frac{k_0}{(1 - e^2 \sin^2\phi)^{1/2}} - -.. math:: - - R = \frac{k_0(1-e^2)}{(1-e^2 \sin^2\phi)^{3/2}} - -.. math:: - - t = \tan(\phi) - -.. math:: - - \eta = \frac{e^2}{1-e^2}cos^2\phi - -.. math:: - - x &= k_0 \lambda \cos \phi \\ - &+ \frac{k_0 \lambda^3 \cos^3\phi}{3!}(1-t^2+\eta^2) \\ - &+ \frac{k_0 \lambda^5 \cos^5\phi}{5!}(5-18t^2+t^4+14\eta^2-58t^2\eta^2) \\ - &+\frac{k_0 \lambda^7 \cos^7\phi}{7!}(61-479t^2+179t^4-t^6) - -.. math:: - - y &= M(\phi) \\ - &+ \frac{k_0 \lambda^2 \sin(\phi) \cos \phi}{2!} \\ - &+ \frac{k_0 \lambda^4 \sin(\phi) \cos^3\phi}{4!}(5-t^2+9\eta^2+4\eta^4) \\ - &+ \frac{k_0 \lambda^6 \sin(\phi) \cos^5\phi}{6!}(61-58t^2+t^4+270\eta^2-330t^2\eta^2) \\ - &+ \frac{k_0 \lambda^8 \sin(\phi) \cos^7\phi}{8!}(1385-3111t^2+543t^4-t^6) - -Inverse projection -================== - -.. math:: - - \phi_1 = M^-1(y) - -.. math:: - - N_1 = \frac{k_0}{1 - e^2 \sin^2\phi_1)^{1/2}} - -.. math:: - - R_1 = \frac{k_0(1-e^2)}{(1-e^2 \sin^2\phi_1)^{3/2}} - -.. math:: - - t_1 = \tan(\phi_1) - -.. math:: - - \eta_1 = \frac{e^2}{1-e^2}cos^2\phi_1 - -.. math:: - - \phi &= \phi_1 \\ - &- \frac{t_1 x^2}{2! R_1 N_1} \\ - &+ \frac{t_1 x^4}{4! R_1 N_1^3}(5+3t_1^2+\eta_1^2-4\eta_1^4-9\eta_1^2t_1^2) \\ - &- \frac{t_1 x^6}{6! R_1 N_1^5}(61+90t_1^2+46\eta_1^2+45t_1^4-252t_1^2\eta_1^2) \\ - &+ \frac{t_1 x^8}{8! R_1 N_1^7}(1385+3633t_1^2+4095t_1^4+1575t_1^6) - -.. math:: - - \lambda &= \frac{x}{\cos \phi N_1} \\ - &- \frac{x^3}{3! \cos \phi N_1^3}(1+2t_1^2+\eta_1^2) \\ - &+ \frac{x^5}{5! \cos \phi N_1^5}(5+6\eta_1^2+28t_1^2-3\eta_1^2+8t_1^2\eta_1^2) \\ - &- \frac{x^7}{7! \cos \phi N_1^7}(61+662t_1^2+1320t_1^4+720t_1^6) - -Further reading -############### - -#. `Wikipedia `_ -#. `EPSG, POSC literature pertaining to Coordinate Conversions and Transformations including Formulas `_ diff --git a/docs/source/usage/operations/projections/tpeqd.rst b/docs/source/usage/operations/projections/tpeqd.rst deleted file mode 100644 index e6d7ef29..00000000 --- a/docs/source/usage/operations/projections/tpeqd.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _tpeqd: - -******************************************************************************** -Two Point Equidistant -******************************************************************************** - -.. image:: ./images/tpeqd.png - :scale: 50% - :alt: Two Point Equidistant - diff --git a/docs/source/usage/operations/projections/tpers.rst b/docs/source/usage/operations/projections/tpers.rst deleted file mode 100644 index 345a5faa..00000000 --- a/docs/source/usage/operations/projections/tpers.rst +++ /dev/null @@ -1,39 +0,0 @@ -.. _tpers: - -******************************************************************************** -Tilted perspective -******************************************************************************** -+---------------------+----------------------------------------------------------+ -| **Classification** | Azimuthal | -+---------------------+----------------------------------------------------------+ -| **Available forms** | Forward and inverse, spherical projection | -+---------------------+----------------------------------------------------------+ -| **Defined area** | Global | -+---------------------+----------------------------------------------------------+ -| **Implemented by** | Gerald I. Evenden | -+---------------------+----------------------------------------------------------+ -| **Options** | -+---------------------+----------------------------------------------------------+ -| `+h` | Height (in meters) above the surface. Required. | -+---------------------+----------------------------------------------------------+ -| `+azi` | Bearing (in degrees) from due north. | -+---------------------+----------------------------------------------------------+ -| `+tilt` | Angle (in degrees) away from nadir. | -+---------------------+----------------------------------------------------------+ -| `+lat_0` | Latitude (in degrees) of the view position. | -+---------------------+----------------------------------------------------------+ -| `+lon_0` | Longitude (in degrees) of the view position. | -+---------------------+----------------------------------------------------------+ - - -.. image:: ./images/tpers.png - :scale: 50% - :alt: Tilted perspective - - -Tilted Perspective is similar to :ref:`nsper` (``nsper``) in that it simulates a -perspective view from a hight. Where ``nsper`` projects onto a plane tangent to -the surface, Tilted Perspective orients the plane towards the direction of the -view. Thus, extra parameters azi and tilt are required beyond `nsper``'s ``h``. -As with ``nsper``, ``lat_0`` & ``lon_0`` are also required -for satellite position. diff --git a/docs/source/usage/operations/projections/ups.rst b/docs/source/usage/operations/projections/ups.rst deleted file mode 100644 index 7a9ab50b..00000000 --- a/docs/source/usage/operations/projections/ups.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _ups: - -******************************************************************************** -Universal Polar Stereographic -******************************************************************************** - -.. image:: ./images/ups.png - :scale: 50% - :alt: Universal Polar Stereographic - diff --git a/docs/source/usage/operations/projections/urm5.rst b/docs/source/usage/operations/projections/urm5.rst deleted file mode 100644 index 91d06308..00000000 --- a/docs/source/usage/operations/projections/urm5.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _urm5: - -******************************************************************************** -Urmaev V -******************************************************************************** - -.. image:: ./images/urm5.png - :scale: 50% - :alt: Urmaev V - diff --git a/docs/source/usage/operations/projections/urmfps.rst b/docs/source/usage/operations/projections/urmfps.rst deleted file mode 100644 index 515ced84..00000000 --- a/docs/source/usage/operations/projections/urmfps.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _urmfps: - -******************************************************************************** -Urmaev Flat-Polar Sinusoidal -******************************************************************************** - -.. image:: ./images/urmfps.png - :scale: 50% - :alt: Urmaev Flat-Polar Sinusoidal - diff --git a/docs/source/usage/operations/projections/utm.rst b/docs/source/usage/operations/projections/utm.rst deleted file mode 100644 index 7fb66cb8..00000000 --- a/docs/source/usage/operations/projections/utm.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _utm: - -******************************************************************************** -Universal Transverse Mercator (UTM) -******************************************************************************** - -.. image:: ./images/utm.png - :scale: 50% - :alt: Universal Transverse Mercator (UTM) - diff --git a/docs/source/usage/operations/projections/vandg.rst b/docs/source/usage/operations/projections/vandg.rst deleted file mode 100644 index cdc772bb..00000000 --- a/docs/source/usage/operations/projections/vandg.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _vandg: - -******************************************************************************** -van der Grinten (I) -******************************************************************************** - -.. image:: ./images/vandg.png - :scale: 50% - :alt: van der Grinten (I) - diff --git a/docs/source/usage/operations/projections/vandg2.rst b/docs/source/usage/operations/projections/vandg2.rst deleted file mode 100644 index 556929e2..00000000 --- a/docs/source/usage/operations/projections/vandg2.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _vandg2: - -******************************************************************************** -van der Grinten II -******************************************************************************** - -.. image:: ./images/vandg2.png - :scale: 50% - :alt: van der Grinten II - diff --git a/docs/source/usage/operations/projections/vandg3.rst b/docs/source/usage/operations/projections/vandg3.rst deleted file mode 100644 index d767c4d5..00000000 --- a/docs/source/usage/operations/projections/vandg3.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _vandg3: - -******************************************************************************** -van der Grinten III -******************************************************************************** - -.. image:: ./images/vandg3.png - :scale: 50% - :alt: van der Grinten III - diff --git a/docs/source/usage/operations/projections/vandg4.rst b/docs/source/usage/operations/projections/vandg4.rst deleted file mode 100644 index 097ba1d8..00000000 --- a/docs/source/usage/operations/projections/vandg4.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _vandg4: - -******************************************************************************** -van der Grinten IV -******************************************************************************** - -.. image:: ./images/vandg4.png - :scale: 50% - :alt: van der Grinten IV - diff --git a/docs/source/usage/operations/projections/vitk1.rst b/docs/source/usage/operations/projections/vitk1.rst deleted file mode 100644 index b9081547..00000000 --- a/docs/source/usage/operations/projections/vitk1.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _vitk1: - -******************************************************************************** -Vitkovsky I -******************************************************************************** - -.. image:: ./images/vitk1.png - :scale: 50% - :alt: Vitkovsky I - diff --git a/docs/source/usage/operations/projections/wag1.rst b/docs/source/usage/operations/projections/wag1.rst deleted file mode 100644 index dd1ed39e..00000000 --- a/docs/source/usage/operations/projections/wag1.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _wag1: - -******************************************************************************** -Wagner I (Kavraisky VI) -******************************************************************************** - -.. image:: ./images/wag1.png - :scale: 50% - :alt: Wagner I (Kavraisky VI) - diff --git a/docs/source/usage/operations/projections/wag2.rst b/docs/source/usage/operations/projections/wag2.rst deleted file mode 100644 index 9c7b0edc..00000000 --- a/docs/source/usage/operations/projections/wag2.rst +++ /dev/null @@ -1,18 +0,0 @@ -.. _wag2: - -******************************************************************************** -Wagner II -******************************************************************************** - -.. image:: ./images/wag2.png - :scale: 50% - :alt: Wagner II - - -.. math:: - - x &= 0.92483 \lambda \cos \theta - - y &= 1.38725\theta - - \sin \theta &= 0.88022 \sin(0.8855\phi) diff --git a/docs/source/usage/operations/projections/wag3.rst b/docs/source/usage/operations/projections/wag3.rst deleted file mode 100644 index fb70a0a6..00000000 --- a/docs/source/usage/operations/projections/wag3.rst +++ /dev/null @@ -1,16 +0,0 @@ -.. _wag3: - -******************************************************************************** -Wagner III -******************************************************************************** - -.. image:: ./images/wag3.png - :scale: 50% - :alt: Wagner III - - -.. math:: - - x &= [\cos\phi_{ts} / \cos ( 2\phi_{ts} / 3)] \lambda \cos (2\phi /3) - - y = \phi diff --git a/docs/source/usage/operations/projections/wag4.rst b/docs/source/usage/operations/projections/wag4.rst deleted file mode 100644 index 7b8dac96..00000000 --- a/docs/source/usage/operations/projections/wag4.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _wag4: - -******************************************************************************** -Wagner IV -******************************************************************************** - -.. image:: ./images/wag4.png - :scale: 50% - :alt: Wagner IV - diff --git a/docs/source/usage/operations/projections/wag5.rst b/docs/source/usage/operations/projections/wag5.rst deleted file mode 100644 index f880290b..00000000 --- a/docs/source/usage/operations/projections/wag5.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _wag5: - -******************************************************************************** -Wagner V -******************************************************************************** - -.. image:: ./images/wag5.png - :scale: 50% - :alt: Wagner V - diff --git a/docs/source/usage/operations/projections/wag6.rst b/docs/source/usage/operations/projections/wag6.rst deleted file mode 100644 index f74749a5..00000000 --- a/docs/source/usage/operations/projections/wag6.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _wag6: - -******************************************************************************** -Wagner VI -******************************************************************************** - -.. image:: ./images/wag6.png - :scale: 50% - :alt: Wagner VI - diff --git a/docs/source/usage/operations/projections/wag7.rst b/docs/source/usage/operations/projections/wag7.rst deleted file mode 100644 index be1401b8..00000000 --- a/docs/source/usage/operations/projections/wag7.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _wag7: - -******************************************************************************** -Wagner VII -******************************************************************************** - -.. image:: ./images/wag7.png - :scale: 50% - :alt: Wagner VII - diff --git a/docs/source/usage/operations/projections/weren.rst b/docs/source/usage/operations/projections/weren.rst deleted file mode 100644 index de7c5abf..00000000 --- a/docs/source/usage/operations/projections/weren.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _weren: - -******************************************************************************** -Werenskiold I -******************************************************************************** - -.. image:: ./images/weren.png - :scale: 50% - :alt: Werenskiold I - diff --git a/docs/source/usage/operations/projections/wink1.rst b/docs/source/usage/operations/projections/wink1.rst deleted file mode 100644 index 00346765..00000000 --- a/docs/source/usage/operations/projections/wink1.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _wink1: - -******************************************************************************** -Winkel I -******************************************************************************** - -.. image:: ./images/wink1.png - :scale: 50% - :alt: Winkel I - diff --git a/docs/source/usage/operations/projections/wink2.rst b/docs/source/usage/operations/projections/wink2.rst deleted file mode 100644 index 7e9b48a7..00000000 --- a/docs/source/usage/operations/projections/wink2.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _wink2: - -******************************************************************************** -Winkel II -******************************************************************************** - -.. image:: ./images/wink2.png - :scale: 50% - :alt: Winkel II - diff --git a/docs/source/usage/operations/projections/wintri.rst b/docs/source/usage/operations/projections/wintri.rst deleted file mode 100644 index bfd5032f..00000000 --- a/docs/source/usage/operations/projections/wintri.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. _wintri: - -******************************************************************************** -Winkel Tripel -******************************************************************************** - -.. image:: ./images/wintri.png - :scale: 50% - :alt: Winkel Tripel - diff --git a/docs/source/usage/operations/transformations/deformation.rst b/docs/source/usage/operations/transformations/deformation.rst deleted file mode 100644 index 2489f18e..00000000 --- a/docs/source/usage/operations/transformations/deformation.rst +++ /dev/null @@ -1,148 +0,0 @@ -.. _deformation: - -================================================================================ -Kinematic datum shifting utilizing a deformation model -================================================================================ - -Perform datum shifts means of a deformation/velocity model. - -+-----------------+--------------------------------------------------------------------+ -| **Input type** | Cartesian coordinates. | -+-----------------+--------------------------------------------------------------------+ -| **Output type** | Cartesian coordinates. | -+-----------------+--------------------------------------------------------------------+ -| **Options** | -+-----------------+--------------------------------------------------------------------+ -| `xy_grids` | Comma-separated list of grids to load. | -+-----------------+--------------------------------------------------------------------+ -| `z_grids` | Comma-separated list of grids to load. | -+-----------------+--------------------------------------------------------------------+ -| `t_epoch` | Central epoch of transformation. [decimalyear]. Only used in | -| | spatiotemporal transformations. | -+-----------------+--------------------------------------------------------------------+ -| `t_obs` | Observation time of coordinate(s). Mostly useful in 2D and 3D | -| | transformations. [decimalyear]. *Optional*. | -+-----------------+--------------------------------------------------------------------+ - -The deformation operation is used to adjust coordinates for intraplate deformations. -Usually the transformation parameters for regional plate-fixed reference frames such as -the ETRS89 does not take intraplate deformation into account. It is assumed that -tectonic plate of the region is rigid. Often times this is true, but near the plate -boundary and in areas with post-glacial uplift the assumption breaks. Tntraplate -deformations can be modelled and then applied to the coordinates so that -they represent the physical world better. In PROJ this is done with the deformation -operation. - -The horizontal grid is stored in CTable2 format and the vertical grid is stored in the -GTX format. Both grids are expected to contain grid-values in units of mm/year. -Details about the formats can be found in the GDAL documentation. GDAL both reads and -writes both file formats. Using GDAL for construction of new grids is recommended. - -Example -------------------------------------------------------------------------------- - -In [Häkli2016]_ coordinate transformation including a deformation model is described. -The paper describes how coordinates from the global ITRFxx frames are transformed to the -local Nordic realisations of ERTS89. Scandinavia is an area with significant post-glacial -rebound. The deformations from the post-glacial uplift is not accounted for in the -offcial ETRS89 transformations so in order to get accurate transformations in the Nordic -countries it is necesarry to apply the deformation model. The transformation from ITRF2008 -to the Danish realisation of ETRS89 is in PROJ described as:: - - proj = pipeline ellps = GRS80 - # ITRF2008@t_obs -> ITRF2000@t_obs - step init = ITRF2008:ITRF2000 - # ITRF2000@t_obs -> ETRF2000@t_obs - step proj=helmert t_epoch = 2000.0 transpose - x = 0.054 rx = 0.000891 drx = 8.1e-05 - y = 0.051 ry = 0.00539 dry = 0.00049 - z = -0.048 rz = -0.008712 drz = -0.000792 - # ETRF2000@t_obs -> NKG_ETRF00@2000.0 - step proj = deformation t_epoch = 2000.0 - xy_grids = ./nkgrf03vel_realigned_xy.ct2 - z_grids = ./nkgrf03vel_realigned_z.gtx - # NKG_ETRF@2000.0 -> ETRF92@2000.0 - step proj=helmert transpose s = -0.009420e - x = 0.03863 rx = 0.00617753 - y = 0.147 ry = 5.064e-05 - z = 0.02776 rz = 4.729e-05 - # ETRF92@2000.0 -> ETRF92@1994.704 - step proj = deformation t_epoch = 1994.704 t_obs = 2000.0 - xy_grids = ./nkgrf03vel_realigned_xy.ct2 - z_grids = ./nkgrf03vel_realigned_z.gtx - -From this we can see that the transformation from ITRF2008 to the Danish realisation of -ETRS89 is a combination of Helmert transformations and adjustments with a deformation -model. The first use of the deformation operation is:: - - proj = deformation t_epoch = 2000.0 - xy_grids = ./nkgrf03vel_realigned_xy.ct2 - z_grids = ./nkgrf03vel_realigned_z.gtx - -Here we set the central epoch of the transformation, 2000.0. The observation epoch -is expected as part of the input coordinate tuple. The deformation model is -described by two grids, specified with *xy_grids* and *z_grids*. The first is -the horizontal part of the model and the second is the vertical component. - -Mathematical description -------------------------------------------------------------------------------- - -Mathematically speaking, application of a deformation model is simple. The deformation model is -represented as a grid of velocities in three dimensions. Coordinate corrections are -applied in cartesian space. For a given coordinate, :math:`(X, Y, Z)`, velocities -:math:`(V_X, V_Y, V_Z)` can be interpolated from the gridded model. The time span -between :math:`t_c` and :math:`t_{obs}` determine the magnitude of the coordinate -correcton as seen in eq. :eq:`apply_velocity` below. - -.. math:: - :label: apply_velocity - - \begin{align} - \begin{pmatrix} - X \\ - Y \\ - Z \\ - \end{pmatrix}_B = - \begin{pmatrix} - X \\ - Y \\ - Z \\ - \end{pmatrix}_A + - (t_c - t_{obs}) - \begin{pmatrix} - V_X \\ - V_Y \\ - V_Z \\ - \end{pmatrix} - \end{align} - -Corrections are done in cartesian space. - -Coordinates of the gridded model are in ENU (east, north, up) space because it would -otherwise require an enormous 3 dimensional grid to handle the corrections in cartesian -space. Keeping the correction in lat/long space reduces the complexity of the grid -significantly. Consequentyly though, the input coordinates needs to be converted to -lat/long space when searching for corrections in the grid. This is done with *cart* -operation. The converted grid corrections can then be applied to the input coordinates -in cartesian space. The conversion from ENU space to cartesian space is done in the -following way: - -.. math:: - :label: enu2xyz - - \begin{align} - \begin{pmatrix} - X \\ - Y \\ - Z \\ - \end{pmatrix} = - \begin{pmatrix} - -\sin\phi \cos\lambda N - \sin\lambda E + \cos\phi \cos\lambda U \\ - -\sin\phi \sin\lambda N + \sin\lambda E + \cos\phi \sin\lambda U \\ - \cos\phi N + \sin\phi U \\ - \end{pmatrix} - \end{align} - -where :math:`\phi` and :math:`\lambda` are the latitude and longitude of the coordinate -that is searched for in the grid. :math:`(E, N, U)` are the grid values in ENU-space and -:math:`(X, Y, Z)` are the corrections converted to cartesian space. diff --git a/docs/source/usage/operations/transformations/helmert.rst b/docs/source/usage/operations/transformations/helmert.rst deleted file mode 100644 index 03e5db15..00000000 --- a/docs/source/usage/operations/transformations/helmert.rst +++ /dev/null @@ -1,388 +0,0 @@ -.. _helmert: - -================================================================================ -Helmert transform -================================================================================ - -The Helmert transformation changes coordinates from one reference frame to -anoether by means of 3-, 4-and 7-parameter shifts, or one of their 6-, 8- and -14-parameter kinematic counterparts. - -+-----------------+-------------------------------------------------------------------+ -| **Input type** | Cartesian coordinates (spatial), decimalyears (temporal). | -+-----------------+-------------------------------------------------------------------+ -| **Output type** | Cartesian coordinates (spatial), decimalyears (temporal). | -+-----------------+-------------------------------------------------------------------+ -| **Options** | -+----------------+--------------------------------------------------------------------+ -| `x` | Translation of the x-axis [m]. *Optional*. | -+----------------+--------------------------------------------------------------------+ -| `y` | Translation of the y-axis [m]. *Optional*. | -+----------------+--------------------------------------------------------------------+ -| `z` | Translation of the z-axis. [m]. *Optional*. | -+----------------+--------------------------------------------------------------------+ -| `s` | Scale factor [ppm]. *Optional*. | -+----------------+--------------------------------------------------------------------+ -| `rx` | X-axis rotation in the 3D Helmert [arc seconds]. *Optional*. | -+----------------+--------------------------------------------------------------------+ -| `ry` | Y-axis rotatoin in the 3D Helmert [arc seconds]. *Optional*. | -+----------------+--------------------------------------------------------------------+ -| `rz` | Z-axis rotation in the 3D Helmert [arc seconds]. *Optional*. | -+----------------+--------------------------------------------------------------------+ -| `theta` | Rotation angle in the 2D Helmert. [arc seconds]. *Optional*. | -+----------------+--------------------------------------------------------------------+ -| `dx` | Translation rate of the x-axis. [m/year]. *Optional*. | -+----------------+--------------------------------------------------------------------+ -| `dy` | Translation rate of the y-axis. [m/year]. *Optional*. | -+----------------+--------------------------------------------------------------------+ -| `dz` | Translation rate of the z-axis. [m/year]. *Optional*. | -+----------------+--------------------------------------------------------------------+ -| `ds` | Scale rate factor [ppm/year]. *Optional*. | -+----------------+--------------------------------------------------------------------+ -| `drx` | Rotation rate of the x-axis [arc seconds/year]. *Optional*. | -+----------------+--------------------------------------------------------------------+ -| `dry` | Rotation rate of the y-axis [arc seconds/year]. *Optional*. | -+----------------+--------------------------------------------------------------------+ -| `drz` | Rotation rate of the y-axis [arc seconds/year]. *Optional*. | -+----------------+--------------------------------------------------------------------+ -| `t_epoch` | Central epoch of transformation. [decimalyear]. Only used in | -| | spatiotemporal transformations. *Optional*. | -+----------------+--------------------------------------------------------------------+ -| `t_obs` | Observation time of coordinate(s). Mostly useful in 2D and 3D | -| | transformations. [decimalyear]. *Optional*. | -+----------------+--------------------------------------------------------------------+ -| `exact` | Use exact transformation equations. *Optional*. | -+----------------+--------------------------------------------------------------------+ -| `transpose` | Transpose rotation matrix. *Optional*. | -+----------------+--------------------------------------------------------------------+ - -The Helmert transform, in all it's various incarnations, is used to perform reference -frame shifts. The transformation operates in cartesian space. It can be used to transform -planar coordinates from one datum to another, transform 3D cartesian -coordinates from one static reference frame to another or it can be used to do fully -kinematic transformations from global reference frames to local static frames. - -All of the parameters described in the table above are marked as optional. This is true -as long as at least one parameter is defined in the setup of the transformation. -The behaviour of the transformation depends on which parameters are used in the setup. -For instance, if a rate of change paramater is specified a kinematic version of the -transformation is used. - -The kinematic transformations require an observation time of the coordinate, as well -as a central epoch for the transformation. The latter is usually documented -alongside the rest of the transformation parameters for a given transformation. -The central eopch is controlled with the parameter `t_epoch`. The observation -time can either by stated as part of the coordinate when using PROJ's -4D-functionality or it can be controlled in the transformation setup by the -parameter `t_obs`. When `t_obs` is specified, all transformed coordinates are -treated as if they have the same observation time. - -Examples -+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ - -Transforming coordinates from NAD72 to NAD83 using the 4 parameter 2D Helmert: - -:: - - proj=helmert ellps=GRS80 x=-9597.3572 y=.6112 - s=0.304794780637 theta=-1.244048 - -Simplified transformations from ITRF2008/IGS08 to ETRS89 using 7 parameters: - -:: - - proj=helmert ellps=GRS80 x=0.67678 y=0.65495 z=-0.52827 - rx=-0.022742 ry=0.012667 rz=0.022704 s=-0.01070 - -Transformation from `ITRF2000@2017.0` to `ITRF93@2017.0` using 15 parameters: - -:: - - proj=helmert ellps=GRS80 - x=0.0127 y=0.0065 z=-0.0209 s=0.00195 - dx=-0.0029 dy=-0.0002 dz=-0.0006 ds=0.00001 - rx=-0.00039 ry=0.00080 rz=-0.00114 - drx=-0.00011 dry=-0.00019 drz=0.00007 - epoch=1988.0 tobs=2017.0 transpose - -Mathematical description -+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ - -In the notation used below, :math:`\hat{P}` is the rate of change of a given transformation -parameter :math:`P`. :math:`\dot{P}` is the kinematically adjusted version of :math:`P`, -described by - -.. math:: - :label: propagation - - \dot{P}= P + \hat{P}\left(t - t_{central}\right) - -where :math:`t` is the observation time of the coordinate and :math:`t_{central}` is -the central epoch of the transformation. Equation :eq:`propagation` can be used to -propagate all transformation parameters in time. - -Superscripts of vectors denote the reference frame the coordinates in the vector belong to. - - -2D Helmert -------------------------------------------------------------------------------- - -The simplest version of the Helmert transform is the 2D case. In the 2-dimensional -case only the horizontal coordinates are changed. The coordinates can be -translated, rotated and scale. Translation is controlled with the `x` and `y` -parameters. The rotation is determined by `theta` and the scale is controlled with -the `s` paramaters. - -.. note:: - - The scaling parameter `s` is unitless for the 2D Helmert, as opposed to the - 3D version where the scaling parameter is given in units of ppm. - -Mathematically the 2D Helmert is described as: - -.. math:: - :label: 4param - - \begin{align} - \begin{bmatrix} - X \\ - Y \\ - \end{bmatrix}^B = - \begin{bmatrix} - T_x \\ - T_y \\ - \end{bmatrix} + - s - \begin{bmatrix} - \hphantom{-}\cos \theta & \sin \theta \\ - -\sin \theta & \cos \theta \\ - \end{bmatrix} - \begin{bmatrix} - X \\ - Y \\ - \end{bmatrix}^A - \end{align} - - -:eq:`4param` can be extended to a time-varying kinematic version by -adjusting the parameters with :eq:`propagation` to :eq:`4param`, which yields -the kinematic 2D Helmert transform: - -.. math:: - :label: 8param - - \begin{align} - \begin{bmatrix} - X \\ - Y \\ - \end{bmatrix}^B = - \begin{bmatrix} - \dot{T_x} \\ - \dot{T_y} \\ - \end{bmatrix} + - s(t) - \begin{bmatrix} - \hphantom{-}\cos \dot{\theta} & \sin \dot{\theta} \\ - -\sin\ \dot{\theta} & \cos \dot{\theta} \\ - \end{bmatrix} - \begin{bmatrix} - X \\ - Y \\ - \end{bmatrix}^A - \end{align} - -All parameters in :eq:`8param` are determined by the use of :eq:`propagation`, -which applies the rate of change to each individual parameter for a given -timespan between :math:`t` and :math:`t_{central}`. - - -3D Helmert -------------------------------------------------------------------------------- - -The general form of the 3D Helmert is - -.. math:: - :label: general-helmert - - - \begin{align} - V^B = T + \left(1 + s \times 10^{-6}\right) \mathbf{R} V^A - \end{align} - -Where :math:`T` is a vector consisting of the three translation parameters, :math:`s` -is the scaling factor and :math:`\mathbf{R}` is a rotation matrix. :math:`V^A` and -:math:`V^B` are coordinate vectors, with :math:`V^A` being the input coordinate and -:math:`V^B` is the output coordinate. - -The rotation matrix is composed of three rotation matrices, one for each axis: - -.. math:: - - \begin{align} - \mathbf{R}_X &= \begin{bmatrix} 1 & 0 & 0\\ 0 & \cos\phi & -\sin\phi\\ 0 & \sin\phi & \cos\phi \end{bmatrix} - \end{align} - -.. math:: - - \begin{align} - \mathbf{R}_Y &= \begin{bmatrix} \cos\theta & 0 & \sin\theta\\ 0 & 1 & 0\\ -\sin\theta & 0 & \cos\theta \end{bmatrix} - \end{align} - -.. math:: - - \begin{align} - \mathbf{R}_Z &= \begin{bmatrix} \cos\psi & -\sin\psi & 0\\ \sin\psi & \cos\psi & 0\\ 0 & 0 & 1 \end{bmatrix} - \end{align} - -The three rotation matrices can be combined in one: - -.. math:: - - \begin{align} - \mathbf{R} = \mathbf{R_X} \mathbf{R_Y} \mathbf{R_Y} - \end{align} - -For :math:`\mathbf{R}`, this yields: - -.. math:: - :label: rot_exact - - \begin{bmatrix} - \cos\theta \cos\psi & -\cos\phi \sin\psi + \sin\phi \sin\theta \cos\psi & \sin\phi \sin\psi + \cos\phi \sin\theta \cos\psi \\ - \cos\theta\sin\psi & \cos\phi \cos\psi + \sin\phi \sin\theta \sin\psi & - \sin\phi \cos\psi + \cos\phi \sin\theta \sin\psi \\ - -\sin\theta & \sin\phi \cos\theta & \cos\phi \cos\theta \\ - \end{bmatrix} - - -Using the small angle approxition the rotation matrix can be simplified to - -.. math:: - :label: rot_approx - - \begin{align} \mathbf{R} = - \begin{bmatrix} - 1 & -R_z & R_y \\ - Rz & 1 & -R_x \\ - -Ry & R_x & 1 \\ - \end{bmatrix} - \end{align} - -Which allow us to express the most common version of the Helmert transform, -using the approximated rotation matrix: - - -.. math:: - :label: 7param - - \begin{align} - \begin{bmatrix} - X \\ - Y \\ - Z \\ - \end{bmatrix}^B = - \begin{bmatrix} - T_x \\ - T_y \\ - T_z \\ - \end{bmatrix} + - \left(1 + s \times 10^{-6}\right) - \begin{bmatrix} - 1 & -R_z & R_y \\ - Rz & 1 & -R_x \\ - -Ry & R_x & 1 \\ - \end{bmatrix} - \begin{bmatrix} - X \\ - Y \\ - Z \\ - \end{bmatrix}^A - \end{align} - -If the rotation matrix is transposed the transformation is effectively reversed. -This is cause for some confusion since there is no correct way of defining the -rotation matrix. Two conventions exists and they seem to be equally popular. -In PROJ the rotation matrix can be transposed by adding the `transpose` flag in -the transformation setup. - -Applying :eq:`propagation` we get the kinematic version of the approximated -3D Helmert: - -.. math:: - :label: 14param - - \begin{align} - \begin{bmatrix} - X \\ - Y \\ - Z \\ - \end{bmatrix}^B = - \begin{bmatrix} - \dot{T_x} \\ - \dot{T_y} \\ - \dot{T_z} \\ - \end{bmatrix} + - \left(1 + \dot{s} \times 10^{-6}\right) - \begin{bmatrix} - 1 & -\dot{R_z} & \dot{R_y} \\ - \dot{R_z} & 1 & -\dot{R_x} \\ - -\dot{R_y} & \dot{R_x} & 1 \\ - \end{bmatrix} - \begin{bmatrix} - X \\ - Y \\ - Z \\ - \end{bmatrix}^A - \end{align} - - - - -The Helmert transformation can be applied without using the rotation parameters, -in which case it becomes a simlpe translation of the origin of the coordinate -system. When using the Helmert in this version equation :eq:`general-helmert` -simplies to: - -.. math:: - :label: 3param - - \begin{align} - \begin{bmatrix} - X \\ - Y \\ - Z \\ - \end{bmatrix}^B = - \begin{bmatrix} - T_x \\ - T_y \\ - T_z \\ - \end{bmatrix} + - \begin{bmatrix} - X \\ - Y \\ - Z \\ - \end{bmatrix}^A - \end{align} - -That after application of :eq:`propagation` has the following kinematic -countpart: - -.. math:: - :label: 6param - - \begin{align} - \begin{bmatrix} - X \\ - Y \\ - Z \\ - \end{bmatrix}^B = - \begin{bmatrix} - \dot{T_x} \\ - \dot{T_y} \\ - \dot{T_z} \\ - \end{bmatrix} + - \begin{bmatrix} - X \\ - Y \\ - Z \\ - \end{bmatrix}^A - \end{align} diff --git a/docs/source/usage/operations/transformations/hgridshift.rst b/docs/source/usage/operations/transformations/hgridshift.rst deleted file mode 100644 index 7f3c9895..00000000 --- a/docs/source/usage/operations/transformations/hgridshift.rst +++ /dev/null @@ -1,39 +0,0 @@ -.. _hgridshift: - -================================================================================ -Horizontal grid shift -================================================================================ - -Change of horizontal datum by grid shift. - -+-----------------+--------------------------------------------------------------------+ -| **Input type** | Geodetic coordinates. | -+-----------------+--------------------------------------------------------------------+ -| **Output type** | Geodetic coordinates. | -+-----------------+--------------------------------------------------------------------+ -| **Options** | -+-----------------+--------------------------------------------------------------------+ -| `+grids` | Comma-separated list of grids to load. | -+-----------------+--------------------------------------------------------------------+ - -The horizontal grid shift is done by offsetting the planar input coordinates by -a specific amount determined by the loaded grids. The simplest use case of the -horizontal grid shift is applying a single grid:: - - +hgridshift +grids=nzgr2kgrid0005.gsb - - -More than one grid can be loaded at the same time, for instance in case the -dataset needs to be transformed spans several countries. In this example grids -of the continental US, Alaska and Canada is loaded at the same time:: - - +hgridshift +grids=@conus,@alaska,@ntv2_0.gsb,@ntv_can.dat - -The ``@`` in the above example states that the grid is optional, in case the grid -is not found in the PROJ search path. The list of grids is prioritized so that -grids in the start of the list takes presedence over the grids in the back of the -list. - -PROJ supports CTable2, NTv1 and NTv2 files for horizontal grid corrections. Details -about all three formats can be found in the GDAL documentation. GDAL reads and -writes all three formats. Using GDAL for construction of new grids is recommended. diff --git a/docs/source/usage/operations/transformations/index.rst b/docs/source/usage/operations/transformations/index.rst deleted file mode 100644 index 5112ffa2..00000000 --- a/docs/source/usage/operations/transformations/index.rst +++ /dev/null @@ -1,17 +0,0 @@ -.. _transformation_list: - -================================================================================ -Transformations -================================================================================ - -Transformations coordinate operation in which the two coordinate reference -systems are based on different datums. - -.. toctree:: - :maxdepth: 1 - - deformation - helmert - molodensky - hgridshift - vgridshift diff --git a/docs/source/usage/operations/transformations/molodensky.rst b/docs/source/usage/operations/transformations/molodensky.rst deleted file mode 100644 index d4ff3e79..00000000 --- a/docs/source/usage/operations/transformations/molodensky.rst +++ /dev/null @@ -1,74 +0,0 @@ -.. _molodensky: - -================================================================================ -Molodensky transform -================================================================================ - -The Molodensky transformation resembles a :ref:`Helmert` with zero -rotations and a scale of unity, but converts directly from geodetic coordinates to -geodetic coordinates, without the intermediate shifts to and from cartesian -geocentric coordinates, associated with the Helmert transformation. -The Molodensky transformation is simple to implement and to parameterize, requiring -only the 3 shifts between the input and output frame, and the corresponding -differences between the semimajor axes and flattening parameters of the reference -ellipsoids. Due to its algorithmic simplicity, it was popular prior to the -ubiquity of digital computers. Today, it is mostly interesting for historical -reasons, but nevertheless indispensable due to the large amount of data that has -already been transformed that way [EversKnudsen2017]_. - -+---------------------+----------------------------------------------------------+ -| **Input type** | Geodetic coordinates. | -+---------------------+----------------------------------------------------------+ -| **Output type** | Geodetic coordinates. | -+---------------------+----------------------------------------------------------+ -| **Options** | -+---------------------+----------------------------------------------------------+ -| `+da` | Difference in semimajor axis of the defining ellipsoids. | -+---------------------+----------------------------------------------------------+ -| `+df` | Difference in flattening of the defining ellipsoids. | -+---------------------+----------------------------------------------------------+ -| `+dx` | Offset of the X-axes of the defining ellipsoids. | -+---------------------+----------------------------------------------------------+ -| `+dy` | Offset of the Y-axes of the defining ellipsoids. | -+---------------------+----------------------------------------------------------+ -| `+dz` | Offset of the Z-axes of the defining ellipsoids. | -+---------------------+----------------------------------------------------------+ -| `+ellps` | Ellipsoid definition of source coordinates. | -| | Any specification can be used (e.g. `+a`, `+rf`, etc). | -|   | If not specified, default ellipsoid is used. | -+---------------------+----------------------------------------------------------+ -| `+abridged` | Use the abridged version of the Molodensky transform. | -| | Optional. | -+---------------------+----------------------------------------------------------+ - -The Molodensky transform can be used to perform a datum shift from coordinate -:math:`(\phi_1, \lambda_1, h_1)` to :math:`(\phi_2, \lambda_2, h_2)` where the two -coordinates are referenced to different ellipsoids. This is based on three -assumptions: - - 1. The cartesian axes, :math:`X, Y, Z`, of the two ellipsoids are parallel. - 2. The offset, :math:`\delta X, \delta Y, \delta Z`, between the two ellipsoid - are known. - 3. The characteristics of the two ellipsoids, expressed as the difference in - semimajor axis (:math:`\delta a`) and flattening (:math:`\delta f`), are known. - -The Molodensky transform is mostly used for transforming between old systems -dating back to the time before computers. The advantage of the Molodensky transform -is that it is fairly simple to compute by hand. The ease of computation come at the -cost of limited accuracy. - -A derivation of the mathematical formulas for the Molodensky transform can be found -in [Deakin2004]_. - - -Examples -############################################################################### - -The abridged Molodensky:: - - proj=molodensky a=6378160 rf=298.25 da=-23 df=-8.120449e-8 dx=-134 dy=-48 dz=149 abridged - -The same transformation using the standard Molodensky:: - - proj=molodensky a=6378160 rf=298.25 da=-23 df=-8.120449e-8 dx=-134 dy=-48 dz=149 - diff --git a/docs/source/usage/operations/transformations/vgridshift.rst b/docs/source/usage/operations/transformations/vgridshift.rst deleted file mode 100644 index e9f78310..00000000 --- a/docs/source/usage/operations/transformations/vgridshift.rst +++ /dev/null @@ -1,41 +0,0 @@ -.. _vgridshift: - -================================================================================ -Vertical grid shift -================================================================================ - -Change Vertical datum change by grid shift - -+-----------------+--------------------------------------------------------------------+ -| **Input type** | Geodetic coordinates (horizontal), meters (vertical). | -+-----------------+--------------------------------------------------------------------+ -| **Output type** | Geodetic coordinates (horizontal), meters (vertical). | -+-----------------+--------------------------------------------------------------------+ -| **Options** | -+-----------------+--------------------------------------------------------------------+ -| `+grids` | Comma-separated list of grids to load. | -+-----------------+--------------------------------------------------------------------+ - -The vertical grid shift is done by offsetting the vertical input coordinates by -a specific amount determined by the loaded grids. The simplest use case of the -horizontal grid shift is applying a single grid. Here we change the vertical -reference from the ellipsoid to the global geoid model, EGM96:: - - +vgridshift +grids=egm96_16.gtx - - -More than one grid can be loaded at the same time, for instance in the case where -a better geoid model than the global is available for a certain area. Here the -gridshift is set up so that the local DVR90 geoid model takes presedence over -the global model:: - - +vgridshift +grids=@dvr90.gtx,egm96_16.gtx - -The ``@`` in the above example states that the grid is optional, in case the grid -is not found in the PROJ search path. The list of grids is prioritized so that -grids in the start of the list takes presedence over the grids in the back of the -list. - -PROJ supports the GTX file format for vertical grid corrections. Details -about all the format can be found in the GDAL documentation. GDAL both reads and -writes the format. Using GDAL for construction of new grids is recommended. diff --git a/docs/source/usage/projections.rst b/docs/source/usage/projections.rst index 645c1eb1..871bc161 100644 --- a/docs/source/usage/projections.rst +++ b/docs/source/usage/projections.rst @@ -5,14 +5,14 @@ Cartographic projection ================================================================================ The foundation of PROJ is the large number of -:doc:`projections` available in the library. This section +:doc:`projections<../operations/projections/index>` available in the library. This section is devoted to the generic parameters that can be used on any projection in the PROJ library. Below is a list of PROJ parameters which can be applied to most coordinate system definitions. This table does not attempt to describe the parameters particular to particular projection types. These can be found on the pages -documenting the individual :doc:`projections`. +documenting the individual :doc:`projections<../operations/projections/index>`. ========== ================================================================ Parameter Description @@ -79,7 +79,7 @@ Longitude Wrapping By default PROJ wraps output longitudes in the range -180 to 180. The ``+over`` switch can be used to disable the default wrapping which is done at a low level in ``pj_inv()``. This is particularly useful with projections like the -:doc:`equidistant cylindrical` +:doc:`equidistant cylindrical<../operations/projections/eqc>` where it would be desirable for X values past -20000000 (roughly) to continue past -180 instead of wrapping to +180. diff --git a/docs/source/usage/quickstart.rst b/docs/source/usage/quickstart.rst index 2cf66122..077e970c 100644 --- a/docs/source/usage/quickstart.rst +++ b/docs/source/usage/quickstart.rst @@ -20,7 +20,7 @@ A proj-strings holds the parameters of a given coordinate transformation, e.g. I.e. a proj-string consists of a projection specifier, ``+proj``, a number of parameters that applies to the projection and, if needed, a description of a datum shift. In the example above geodetic coordinates are transformed to -projected space with the :doc:`Mercator projection` with +projected space with the :doc:`Mercator projection<../operations/projections/merc>` with the latitude of true scale at 56.5 degrees north on the GRS80 ellipsoid. Every projection in PROJ is identified by a shorthand such as ``merc`` in the above example. diff --git a/docs/source/usage/transformation.rst b/docs/source/usage/transformation.rst index 2f5ee880..fd1f2f94 100644 --- a/docs/source/usage/transformation.rst +++ b/docs/source/usage/transformation.rst @@ -289,7 +289,7 @@ no grid is found that contains the point to be transformed an error will occur. 111d0'2.788"W 43d59'59.725"N 0.000 111dW 55dN 0.000 -For more information see the chapter on :ref:`Grids`. +For more information see the chapter on :ref:`transformation_grids`. Caveats ................................................................................ -- cgit v1.2.3